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 캔들, 거래량, 분석, 프로필, 가격선 및 마커용 명령형 브라우저 차트.
가져오기 @sixtyfold/stock·클래스
class StockChart| 멤버 | 정의 | 설명 |
|---|---|---|
add | (timestamp: number, open: number, high: number, low: number, close: number, volume: number) => void | 스트리밍 버퍼에 하나의 OHLCV 캔들을 추가하며, 빠른 연속 호출을 하나의 애니메이션 프레임으로 배치합니다. |
add | (batches: readonly StockCandleBatch[], options?: StockAddCandlesOptions) => void | 여러 OHLCV 청크를 하나의 렌더러 업데이트에 설치합니다. Worker 모드에서는 각 청크 버퍼를 전송하고 분리(detach)하며; 메인 스레드 모드에서는 배열을 참조로 유지합니다. |
add | (timestamps: Float64Array, opens: Float64Array, highs: Float64Array, lows: Float64Array, closes: Float64Array, volumes: Float64Array, options?: StockAddCandlesOptions) => void | 한 번의 렌더러 업데이트에서 정렬된 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를 throw합니다. |
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 | 뷰포트 범위를 프로그래밍으로 설정합니다. xMin 및/또는 xMax 만 제공하면 되며; 누락된 필드는 현재 값을 유지합니다. |
set | (volumeProfile: VolumeProfileOptions | false) => void | 추정된 캔들 유래 가시 범위 볼륨 프로파일을 교체하거나 비활성화합니다. |
update | (patch: DeepPartial<BaseAppearanceOptions>) => void | 런타임에 변경 가능한 외형 옵션을 패치합니다. 예외: 잘못된 레이블이나 희소/비-객체 custom 항목에 대해 TypeError을(를) 던집니다. |