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 캔들, 거래량, 분석, 프로필, 가격선 및 마커용 명령형 브라우저 차트입니다.

Import @sixtyfold/stockclass

class StockChart
MemberDefinitionDescription
addCandle(timestamp: number, open: number, high: number, low: number, close: number, volume: number) => void대기열에 있는 각 촛대 뒤에 엄격히 더 큰 유한 타임스탬프를 가진 하나의 OHLCV 캔들를 큐에 추가합니다. 빠른 연속 호출은 하나의 애니메이션 프레임으로 배치되며; 동일한 타임스탬프를 반복하는 것은 업데이트 동작이 아닙니다.
addCandleBatches(batches: readonly StockCandleBatch[], options?: StockAddCandlesOptions) => void플러시하기 전에 모든 OHLCV 청크의 열 길이가 동일한지, 청크 간 및 이전 추가 항목들에 걸쳐 타임스탬프가 유한하고 엄격히 증가하는지를 검증합니다. Worker 모드에서는 유효한 버퍼를 전송하고; 메인 스레드 모드에서는 배열을 참조로 유지합니다.
addCandles(timestamps: Float64Array, opens: Float64Array, highs: Float64Array, lows: Float64Array, closes: Float64Array, volumes: Float64Array, options?: StockAddCandlesOptions) => void플러시 전에 큐에 있거나 추가된 모든 캔들에 대해 크기가 동일한 6개의 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를 던집니다.
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타임스탬프 범위를 설정합니다. 마켓 시간에서는 누락된 경계가 이전 요청 후 렌더러에서 해석되며, 수락된 범위 동기화 후 getViewport() 가 호출됩니다.
setVolumeProfile(volumeProfile: VolumeProfileOptions | false) => void추정된 캔들 기반 가시 범위 볼륨 프로필을 교체하거나 비활성화합니다.
updateAppearance(patch: DeepPartial<BaseAppearanceOptions>) => void실행 중에 변경 가능한 표시 옵션을 패치합니다. 예외: 잘못된 레이블이나 희소/비객체 custom 항목의 경우 TypeError를 발생시킵니다.