StockChart API

Import

import { StockChart } from "@sixtyfold/stock";

Verwenden Sie den oben gezeigten öffentlichen Einstiegspunkt. Reine Typimporte werden aus dem Anwendungs-JavaScript entfernt.

`ChartOverlayError`

Fehler, der gemeldet wird, wenn eine oder mehrere deklarative Overlay‑Quellen nicht angewendet werden können.

Import @sixtyfold/stockclass

class ChartOverlayError extends Error

Member	Definition	Description
`cause?`	`Error \| undefined`	Ursache für Fehler in der Chart-Überlagerung.
`message`	`string`	Nachrichtentext.
`name`	`"ChartOverlayError"`	Anzeigename für diesen Chart-Overlay-Fehler.
`sources`	`readonly string[]`	Quellen für Chart-Overlay-Fehler.
`stack?`	`string \| undefined`	Stack-Text.

`ChartRendererError`

Fehler, der gemeldet wird, wenn ein Chart-Renderer beim Start oder während der Nutzung ausfällt.

Import @sixtyfold/stockclass

class ChartRendererError extends Error

Member	Definition	Beschreibung
`cause?`	`Error \| undefined`	Ursache für einen Fehler des Chart-Renderers.
`message`	`string`	Nachrichtentext.
`name`	`"ChartRendererError"`	Anzeigename für diesen Chart-Renderer-Fehler.
`phase`	`RendererFailurePhase`	Phase des Chart-Renderer-Fehlers.
`stack?`	`string \| undefined`	Stack-Text.

`StockChart`

Imperativer Browser-Chart für aggregierte OHLCV-Candles, Volumen, Analysen, Profile, Preislinien und Marker.

Import @sixtyfold/stockKlasse

class StockChart

Mitglied	Definition	Beschreibung
`addCandle`	`(timestamp: number, open: number, high: number, low: number, close: number, volume: number) => void`	Hängt eine OHLCV-Kerze an den Streaming-Puffer an und fasst schnelle Aufrufe zu einem einzigen Animationsframe zusammen.
`addCandleBatches`	`(batches: readonly StockCandleBatch[], options?: StockAddCandlesOptions) => void`	Installiert mehrere OHLCV-Chunks in einem Renderer-Update. Im Worker-Modus werden alle Chunk-Buffer übertragen und abgetrennt; im Main-Thread-Modus bleiben die Arrays per Referenz erhalten.
`addCandles`	`(timestamps: Float64Array, opens: Float64Array, highs: Float64Array, lows: Float64Array, closes: Float64Array, volumes: Float64Array, options?: StockAddCandlesOptions) => void`	Fügt ausgerichtete OHLCV-Spalten in einem Renderer-Update hinzu. Im Worker-Modus werden die gelieferten Buffer übertragen und abgetrennt; im Main-Thread-Modus bleiben die Arrays per Referenz erhalten.
`batch`	`(fn: () => void) => void`	Fasst synchrone Appearance- und Viewport-Änderungen in einem Update zusammen. Verschachtelte Batches werden kombiniert; Datenladeaufrufe laufen sofort.
`destroy`	`() => void`	Gibt das Chart und seine verwalteten Ressourcen frei.
`getAppearance`	`() => DeepReadonly<StockAppearanceOptions>`	Gibt einen schreibgeschützten Snapshot des veränderlichen Appearance‑Untersatzes zurück.
`getOptions`	`() => DeepReadonly<StockChartOptions>`	Gibt einen vollständigen normalisierten schreibgeschützten Snapshot aller Optionen zurück (Konstruktion + aktuelle Darstellung).
`getRenderMode`	`() => "worker" \| "main"`	Gibt den aufgelösten Render-Modus zurück ("Worker" oder "Hauptthread").
`getViewport`	`() => Viewport`	Gibt einen Snapshot des aktuellen Viewports zurück.
`initialize`	`() => Promise<void>`	Warten Sie, bis der Renderer für Daten und Laufzeitbefehle bereit ist. Der zur Konstruktionzeit eingesetzte Initialisierungs-Watchdog weist dieses Promise mit einem `ChartRendererError` zurück, wenn der Worker- oder Hauptthread-Fallback innerhalb des konfigurierten Intervalls nicht bereit wird. Anwendungen sollten diese Methode abwarten, bevor sie ihren ersten Datensatz installieren.
`initStreaming`	`(maxCandles?: number) => void`	Allokiert einen Ringpuffer mit fester Kapazität für OHLCV zur Live-Aktualisierung.
`reset`	`(options?: { animated?: boolean; }) => void`	Setzt die Ansicht auf den vollständigen Datenbereich zurück.
`resize`	`() => void`	Synchronisiert den Renderer mit der Canvas‑Größe.
`setData`	`(data: OHLCVData) => void`	Lädt ausgerichtete OHLCV-Spalten und übergibt dem Renderer die Eigentümerschaft an den normalisierten Arrays. Im Worker-Modus werden die Buffer übertragen und abgetrennt; im Main-Thread-Modus bleiben sie per Referenz erhalten.
`setIndicators`	`(indicators: StockIndicator[]) => void`	Ersetzt die eingebauten Definitionen technischer Indikatoren.
`setKeyboardAnnouncements`	`(messages: false \| KeyboardAnnouncementMessages) => void`	Ersetzt oder deaktiviert zur Laufzeit die lokalisierten Tastatur-Aktionsansagen. Ausstehende Ansagen werden abgebrochen.
`setLabels`	`(labels: ChartLabels) => void`	Aktualisiert Chart-Beschriftungen zur Laufzeit. Fügt in vorhandene Beschriftungen zusammen (gleiche Semantik wie updateAppearance). Wirft: TypeError bei fehlerhaften Beschriftungen oder spärlichen/nicht-Objekt-`custom`-Einträgen.
`setMarkers`	`(markers: StockMarker[]) => void`	Ersetzt alle spärlichen Zeitstempel/Preis-Markierungen.
`setOverlay`	`(overlay: OverlayOptions) => Promise<void>`	Aktualisieren Sie deklarative Overlay-Primitiven zur Laufzeit. Gültige Primitiven und erfolgreich dekodierte Bilder werden installiert, selbst wenn ein anderes Bild fehlschlägt. Wenn jedes angeforderte Element fehlschlägt, bleibt das zuvor gerenderte Overlay installiert. Auflösungs- und Renderer-Zustellfehler lehnen mit `ChartOverlayError` ab; registrieren Sie `setOverlayErrorCallback`, wenn die Anwendung außerdem asynchrone Benachrichtigung benötigt. Wird vor Bereitschaft des Lazy-Renderers aufgerufen, enthält dieses Promise das Warten auf die Bereitschaft. Ersetzte Updates und Chart-Zerstörung sind routinemäßige Abbrüche und lösen auf, ohne zu installieren.
`setOverlayErrorCallback`	`(callback: OverlayErrorCallback \| null) => void`	Registriert einen Rückruf für nicht-fatalen Overlay-Auflösungs- oder Zustellungsfehler. Erfolgreiche Overlay-Elemente werden dennoch installiert. Das übereinstimmende `setOverlay`-Promise lehnt ebenfalls mit demselben Fehler ab.
`setPriceLines`	`(priceLines: StockPriceLine[]) => void`	Ersetzt alle horizontal datenverankerten Preisniveaus.
`setRendererErrorCallback`	`(callback: RendererErrorCallback \| null) => void`	Registriert einen einmaligen Renderer-Fehler-Rückruf. Wird einmalig vor dem Aufräumen bei Initialisierungs- oder Laufzeitfehlern aufgerufen. Ohne Rückruf verwenden Fehler `console.error`. Übergeben Sie `null`, um ihn zu kündigen; `destroy`-Aufrufe rufen ihn nicht auf.
`setStatsCallback`	`(callback: ((stats: StockChartStats) => void) \| null, options?: StockChartStatsOptions) => void`	Aktiviert Renderer-Statistiken und empfängt gedrosselte Schnappschüsse. Übergeben Sie `null`, um diese zu deaktivieren.
`setTimeRange`	`(range: TimeRange) => void`	Wendet eines der exportierten Kalender-/Session‑Presets an. Das Chart rendert keine Steuerelemente. Anwendungsseitige Steuerelemente können diese Methode für ein Preset oder `setViewport()` für einen beliebigen Zeitstempelbereich aufrufen.
`setViewport`	`(viewport: Partial<Viewport>, options?: { animated?: boolean; }) => void`	Setzt programmgesteuert den Viewport‑Bereich. Es müssen nur `xMin` und/oder `xMax` angegeben werden; ausgelassene Felder behalten die aktuellen Werte.
`setVolumeProfile`	`(volumeProfile: VolumeProfileOptions \| false) => void`	Ersetzt oder deaktiviert das geschätzte, aus Kerzen abgeleitete sichtbare Volumenprofil.
`updateAppearance`	`(patch: DeepPartial<BaseAppearanceOptions>) => void`	Patchen Sie änderbare Darstellungsoptionen zur Laufzeit. Wirft: TypeError bei fehlerhaften Labels oder spärlichen/nicht-Objekt-`custom`-Einträgen.