StockChart API

StockChart는 OHLCV 데이터 로드, 캔들 스트리밍, 범위 제어 및 마켓 레이어 추가를 위한 메서드입니다.

가져오기
import { StockChart } from "@sixtyfold/stock";

위에 표시된 공개 진입점을 사용하세요. 타입 전용 가져오기는 애플리케이션 JavaScript에서 제거됩니다.

ChartOverlayError

하나 이상의 선언적 오버레이 소스를 적용할 수 없을 때 보고되는 오류입니다.

가져오기 @sixtyfold/stock클래스

class ChartOverlayError extends Error
멤버정의설명
cause?Error | undefined차트 오버레이 오류의 원인.
messagestring메시지 텍스트.
name"ChartOverlayError"이 차트 오버레이 오류의 표시 이름.
sourcesreadonly string[]차트 오버레이 오류의 출처들.
stack?string | undefined스택 텍스트.

ChartRendererError

차트 렌더러가 시작 시 또는 이후 사용 중에 실패할 때 보고되는 오류.

가져오기 @sixtyfold/stock클래스

class ChartRendererError extends Error
멤버정의설명
cause?Error | undefined차트 렌더러 오류의 원인.
messagestring메시지 텍스트.
name"ChartRendererError"이 차트 렌더러 오류의 표시 이름입니다.
phaseRendererFailurePhase차트 렌더러 오류의 단계입니다.
stack?string | undefined스택 텍스트입니다.

StockChart

집계된 OHLCV 캔들, 거래량, 분석, 프로필, 가격선 및 마커용 명령형 브라우저 차트.

가져오기 @sixtyfold/stock클래스

class StockChart
멤버정의설명
addCandle(timestamp: number, open: number, high: number, low: number, close: number, volume: number) => void스트리밍 버퍼에 하나의 OHLCV 캔들을 추가하며, 빠른 연속 호출을 하나의 애니메이션 프레임으로 배치합니다.
addCandleBatches(batches: readonly StockCandleBatch[], options?: StockAddCandlesOptions) => void여러 OHLCV 청크를 하나의 렌더러 업데이트에 설치합니다. Worker 모드에서는 각 청크 버퍼를 전송하고 분리(detach)하며; 메인 스레드 모드에서는 배열을 참조로 유지합니다.
addCandles(timestamps: Float64Array, opens: Float64Array, highs: Float64Array, lows: Float64Array, closes: Float64Array, volumes: Float64Array, options?: StockAddCandlesOptions) => void한 번의 렌더러 업데이트에서 정렬된 OHLCV 열을 추가합니다. Worker 모드에서는 제공된 버퍼를 전송하고 분리하며; 메인 스레드 모드에서는 배열을 참조로 유지합니다.
batch(fn: () => void) => void동기적 표시 및 뷰포트 변경을 하나의 업데이트로 그룹화합니다. 중첩된 배치는 병합되며; 데이터 로딩 호출은 여전히 즉시 실행됩니다.
destroy() => void차트와 그가 소유한 리소스를 해제합니다.
getAppearance() => DeepReadonly<StockAppearanceOptions>변경 가능한 표시 항목의 읽기 전용 스냅샷을 반환합니다.
getOptions() => DeepReadonly<StockChartOptions>모든 옵션(생성 시 + 현재 표시)을 완전하게 정규화된 읽기 전용 스냅샷으로 반환합니다.
getRenderMode() => "worker" | "main"렌더링 모드(“Worker” 또는 “메인”)로 해석된 값을 반환합니다.
getViewport() => Viewport현재 뷰포트의 스냅샷을 반환합니다.
initialize() => Promise<void>렌더러가 데이터와 런타임 명령을 처리할 준비가 될 때까지 대기합니다. 생성 시 초기화 감시자가 구성된 시간 내에 Worker 또는 메인 스레드 폴백이 준비되지 않으면 이 프라미스는 ChartRendererError로 거부됩니다. 애플리케이션은 첫 데이터셋을 설치하기 전에 이 메서드를 await해야 합니다.
initStreaming(maxCandles?: number) => void실시간 업데이트를 위한 고정 용량 OHLCV 링 버퍼를 할당합니다.
reset(options?: { animated?: boolean; }) => void뷰포트를 전체 데이터 범위로 재설정합니다.
resize() => void렌더러를 캔버스 크기와 동기화합니다.
setData(data: OHLCVData) => void정렬된 OHLCV 열을 로드하고 정규화된 배열에 대한 렌더러의 소유권을 부여합니다. Worker 모드에서는 버퍼를 전송하고 분리하며; 메인 스레드 모드에서는 배열을 참조로 유지합니다.
setIndicators(indicators: StockIndicator[]) => void내장 기술 지표 정의를 대체합니다.
setKeyboardAnnouncements(messages: false | KeyboardAnnouncementMessages) => void런타임에 지역화된 키보드 동작 안내를 교체하거나 비활성화합니다. 기존 대기 중인 안내는 취소됩니다.
setLabels(labels: ChartLabels) => void런타임에 차트 레이블을 업데이트합니다. 기존 레이블에 병합됩니다(updateAppearance와 동일한 의미). 잘못된 레이블 또는 희소/객체가 아닌 custom 항목에 대해서는 TypeError를 throw합니다.
setMarkers(markers: StockMarker[]) => void모든 희소 타임스탬프/가격 마커를 대체합니다.
setOverlay(overlay: OverlayOptions) => Promise<void>런타임에 선언형 오버레이 프리미티브를 업데이트합니다. 유효한 프리미티브와 정상적으로 디코딩된 이미지는 다른 이미지가 실패해도 설치됩니다. 요청된 항목이 전부 실패하면 이전에 렌더된 오버레이가 계속 설치된 상태로 남습니다. 해상도 또는 렌더러 전달 실패는 ChartOverlayError로 거부되며, 애플리케이션이 비동기 알림도 필요하면 setOverlayErrorCallback를 등록하세요. 게으른 렌더러가 준비되기 전에 호출되면 이 프로미스는 준비 대기를 포함합니다. 대체된 업데이트와 차트 파괴는 일반적인 취소로 처리되며 설치하지 않고 해결됩니다.
setOverlayErrorCallback(callback: OverlayErrorCallback | null) => void비치명적 오버레이 해상도 또는 전달 실패에 대한 콜백을 등록합니다. 성공한 오버레이 항목은 계속 설치됩니다. 일치하는 setOverlay 프로미스도 동일한 오류로 거부됩니다.
setPriceLines(priceLines: StockPriceLine[]) => void모든 수평 데이터 고정 가격 레벨을 교체합니다.
setRendererErrorCallback(callback: RendererErrorCallback | null) => void일회성 렌더러 실패 콜백을 등록합니다. 초기화 또는 런타임 실패에 대해 분해 전에 한 번 호출됩니다. 콜백이 없으면 오류는 console.error를 사용합니다. 취소하려면 null를 전달하세요; destroy 호출은 이 콜백을 호출하지 않습니다.
setStatsCallback(callback: ((stats: StockChartStats) => void) | null, options?: StockChartStatsOptions) => void렌더러 통계를 활성화하고 제한된 스냅샷을 수신합니다. 비활성화하려면 null 를 전달하세요.
setTimeRange(range: TimeRange) => void내보낸 캘린더/세션 프리셋 중 하나를 적용합니다. 차트는 컨트롤을 렌더링하지 않습니다. 애플리케이션 소유의 컨트롤은 프리셋에 대해 이 메서드를 호출하거나 임의의 타임스탬프 범위에는 setViewport() 를 호출할 수 있습니다.
setViewport(viewport: Partial<Viewport>, options?: { animated?: boolean; }) => void뷰포트 범위를 프로그래밍으로 설정합니다. xMin 및/또는 xMax 만 제공하면 되며; 누락된 필드는 현재 값을 유지합니다.
setVolumeProfile(volumeProfile: VolumeProfileOptions | false) => void추정된 캔들 유래 가시 범위 볼륨 프로파일을 교체하거나 비활성화합니다.
updateAppearance(patch: DeepPartial<BaseAppearanceOptions>) => void런타임에 변경 가능한 외형 옵션을 패치합니다. 예외: 잘못된 레이블이나 희소/비-객체 custom 항목에 대해 TypeError을(를) 던집니다.