StockChart API
StockChart는 OHLCV 데이터를 로드하고, 캔들을 스트리밍하며, 범위를 제어하고, 마켓 레이어를 추가하는 메서드입니다.
import { StockChart } from "@sixtyfold/stock";위에 표시된 공개 진입점을 사용하세요. 타입 전용 가져오기는 애플리케이션 JavaScript에서 제거됩니다.
ChartOverlayError
하나 이상의 선언적 오버레이 소스를 적용할 수 없을 때 보고되는 오류입니다.
가져오기 @sixtyfold/stock·클래스
class ChartOverlayError extends Error| 멤버 | 정의 | 설명 |
|---|---|---|
cause? | Error | undefined | 차트 오버레이 오류의 원인. |
message | string | 메시지 텍스트. |
name | "ChartOverlayError" | 이 차트 오버레이 오류의 표시 이름입니다. |
sources | readonly string[] | 차트 오버레이 오류의 출처들입니다. |
stack? | string | undefined | 스택 텍스트입니다. |
ChartRendererError
차트 렌더러가 시작 시점 또는 이후 사용 중에 실패할 때 보고되는 오류입니다.
가져오기 @sixtyfold/stock·클래스
class ChartRendererError extends Error| 멤버 | 정의 | 설명 |
|---|---|---|
cause? | Error | undefined | 차트 렌더러 오류의 원인. |
message | string | 메시지 텍스트. |
name | "ChartRendererError" | 이 차트 렌더러 오류의 표시 이름입니다. |
phase | RendererFailurePhase | 차트 렌더러 오류의 단계입니다. |
stack? | string | undefined | 스택 텍스트입니다. |
StockChart
집계된 OHLCV 캔들, 거래량, 분석, 프로필, 가격선 및 마커용 명령형 브라우저 차트입니다.
Import @sixtyfold/stock·class
class StockChart| Member | Definition | Description |
|---|---|---|
add | (timestamp: number, open: number, high: number, low: number, close: number, volume: number) => void | 대기열에 있는 각 촛대 뒤에 엄격히 더 큰 유한 타임스탬프를 가진 하나의 OHLCV 캔들를 큐에 추가합니다. 빠른 연속 호출은 하나의 애니메이션 프레임으로 배치되며; 동일한 타임스탬프를 반복하는 것은 업데이트 동작이 아닙니다. |
add | (batches: readonly StockCandleBatch[], options?: StockAddCandlesOptions) => void | 플러시하기 전에 모든 OHLCV 청크의 열 길이가 동일한지, 청크 간 및 이전 추가 항목들에 걸쳐 타임스탬프가 유한하고 엄격히 증가하는지를 검증합니다. Worker 모드에서는 유효한 버퍼를 전송하고; 메인 스레드 모드에서는 배열을 참조로 유지합니다. |
add | (timestamps: Float64Array, opens: Float64Array, highs: Float64Array, lows: Float64Array, closes: Float64Array, volumes: Float64Array, options?: StockAddCandlesOptions) => void | 플러시 전에 큐에 있거나 추가된 모든 캔들에 대해 크기가 동일한 6개의 OHLCV 열과 유한하고 엄격히 증가하는 타임스탬프를 검증합니다. 잘못된 입력은 큐에 있는 캔들을 보존하고 호출자 버퍼를 유지합니다; Worker 모드에서는 유효한 버퍼를 전송하고 메인 스레드 모드에서는 배열을 참조로 유지합니다. |
batch | (fn: () => void) => void | 동기적 외관 및 뷰포트 변경을 하나의 업데이트로 그룹화합니다. 중첩된 배치는 병합되며; 데이터 로딩 호출은 여전히 즉시 실행됩니다. |
destroy | () => void | 차트와 그 소유 리소스를 해제합니다. |
get | () => DeepReadonly<StockAppearanceOptions> | 변경 가능한 외관 하위집합의 읽기 전용 스냅샷을 반환합니다. |
get | () => DeepReadonly<StockChartOptions> | 모든 옵션(생성 시 옵션 + 현재 외형)을 정규화된 읽기 전용 전체 스냅샷으로 반환합니다. |
get | () => "worker" | "main" | 렌더링 모드("Worker" 또는 "메인")로 해석된 값을 반환합니다. |
get | () => Viewport | 현재 뷰포트의 스냅샷을 반환합니다. |
initialize | () => Promise<void> | 렌더러가 데이터와 런타임 명령을 처리할 준비가 될 때까지 대기합니다. 생성 시 초기화 워치독은 구성된 시간 내에 Worker 또는 메인 스레드 폴백이 준비되지 않으면 이 프라미스를 ChartRendererError로 거부합니다. 애플리케이션은 첫 데이터셋을 설정하기 전에 이 메서드를 await해야 합니다. |
init | (maxCandles?: number) => void | 라이브 업데이트를 위해 양의 정수 OHLCV 링 버퍼 용량을 할당합니다. 대기 중인 캔들 및 타임스탬프 정렬 상태를 재설정하고 이전 데이터셋의 보류 중인 뷰포트 애니메이션을 취소합니다. |
reset | (options?: { animated?: boolean; }) => void | 뷰포트를 전체 데이터 범위로 재설정합니다. |
resize | () => void | 렌더러를 캔버스 크기와 동기화합니다. |
set | (data: OHLCVData) => void | 유한하고 단조 증가 또는 단조 감소하는(동일한 타임스탬프 포함) 타임스탬프를 가진 동일한 크기의 여섯 개 OHLCV 열을 로드하고 순서를 정규화합니다. Worker 모드에서는 정규화된 버퍼를 전송하고 메인 스레드 모드에서는 배열을 참조로 유지합니다. 대기 중인 스트리밍 샘플을 교체하고 이전 뷰포트 애니메이션을 취소합니다. |
set | (indicators: StockIndicator[]) => void | 내장 기술 지표 정의를 대체합니다. |
set | (messages: false | KeyboardAnnouncementMessages) => void | 실행 시간에 지역화된 키보드 동작 안내를 교체하거나 비활성화합니다. 대기 중인 기존 안내는 취소됩니다. |
set | (labels: ChartLabels) => void | 실행 시간에 차트 레이블을 업데이트합니다. 기존 레이블에 병합됩니다(updateAppearance와 동일한 의미). 잘못된 레이블이나 희소하거나 객체가 아닌 custom 항목에 대해서는 TypeError를 던집니다. |
set | (markers: StockMarker[]) => void | 모든 희소한 타임스탬프/가격 마커를 교체합니다. |
set | (overlay: OverlayOptions) => Promise<void> | 선언적 오버레이 프리미티브를 런타임에 업데이트합니다. 유효한 프리미티브와 성공적으로 디코딩된 이미지는 다른 이미지가 실패하더라도 설치됩니다. 요청한 모든 항목이 실패하면 이전에 렌더된 오버레이가 그대로 유지됩니다. 해상도 및 렌더러 전달 실패는 ChartOverlayError로 거부됩니다; 애플리케이션이 비동기 알림도 필요하면 setOverlayErrorCallback를 등록하십시오. 지연 렌더러가 준비되기 전에 호출되면 이 프라미스에 준비 대기가 포함됩니다. 대체된 업데이트 및 차트 소멸은 일반적인 취소로 처리되며 설치 없이 해결됩니다. |
set | (callback: OverlayErrorCallback | null) => void | 비치명적 오버레이 해상도 또는 전달 실패에 대한 콜백을 등록합니다. 성공한 오버레이 항목은 여전히 설치됩니다. 일치하는 setOverlay 프라미스도 동일한 오류로 거부됩니다. |
set | (priceLines: StockPriceLine[]) => void | 모든 수평 데이터 고정 가격 레벨을 교체합니다. |
set | (callback: RendererErrorCallback | null) => void | 일회성 렌더러 실패 콜백을 등록합니다. 초기화 또는 런타임 실패에 대해 해체 전에 한 번 호출됩니다. 콜백이 없으면 오류는 console.error를 사용합니다. 취소하려면 null를 전달하십시오; destroy 호출은 이를 호출하지 않습니다. |
set | (callback: ((stats: StockChartStats) => void) | null, options?: StockChartStatsOptions) => void | 렌더러 통계를 활성화하고 제한된 스냅샷을 수신합니다. 비활성화하려면 null 를 전달하세요. |
set | (range: TimeRange) => void | 내보낸 캘린더/세션 프리셋 중 하나를 적용합니다. 차트는 컨트롤을 렌더링하지 않습니다. 애플리케이션이 소유한 컨트롤은 프리셋에 대해 이 메서드를 호출하거나 임의의 타임스탬프 범위에 대해 setViewport() 를 호출할 수 있습니다. |
set | (viewport: Partial<Viewport>, options?: { animated?: boolean; }) => void | 타임스탬프 범위를 설정합니다. 마켓 시간에서는 누락된 경계가 이전 요청 후 렌더러에서 해석되며, 수락된 범위 동기화 후 getViewport() 가 호출됩니다. |
set | (volumeProfile: VolumeProfileOptions | false) => void | 추정된 캔들 기반 가시 범위 볼륨 프로필을 교체하거나 비활성화합니다. |
update | (patch: DeepPartial<BaseAppearanceOptions>) => void | 실행 중에 변경 가능한 표시 옵션을 패치합니다. 예외: 잘못된 레이블이나 희소/비객체 custom 항목의 경우 TypeError를 발생시킵니다. |