Summarizer: summarizeStreaming() Methode

Syntax

summarizeStreaming(input)
summarizeStreaming(input, options)

Parameter

input

Ein String, der den zu zusammenfassenden Text darstellt.

options Optional

Ein Objekt, das Konfigurationsoptionen für die summarizeStreaming()-Operation angibt. Mögliche Werte sind:

context

Ein String, der den Kontext beschreibt, in dem der Eingabetext verwendet wird, was dem Summarizer hilft, eine geeignetere Zusammenfassung zu erstellen.

signal

Eine AbortSignal-Objektinstanz, die es ermöglicht, die summarizeStreaming()-Operation über den zugehörigen AbortController abzubrechen.

Rückgabewert

Ein ReadableStream, der die generierte Zusammenfassung enthält.

Ausnahmen

AbortError DOMException

Wird ausgelöst, wenn der Summarizer zuvor zerstört wurde (mit Summarizer.destroy() aufgerufen, oder wenn er nach seiner Erstellung über sein Abbruch-signal abgebrochen wurde).

InvalidStateError DOMException

Wird ausgelöst, wenn das aktuelle Document nicht aktiv ist.

NotAllowedError DOMException

Wird ausgelöst, wenn die Nutzung der Summarizer API durch eine summarizer Permissions-Policy blockiert ist.

NotReadableError DOMException

Wird ausgelöst, wenn die Ausgabenzusammenfassung vom Benutzeragenten gefiltert wurde, zum Beispiel weil sie als schädlich, ungenau oder unsinnig erkannt wurde.

NotSupportedError DOMException

Wird ausgelöst, wenn der bereitgestellte context nicht in einer vom Summarizer unterstützten Sprache ist.

QuotaExceededError

Wird ausgelöst, wenn die Zusammenfassungsoperation das verfügbare inputQuota überschreitet.

UnknownError DOMException

Wird ausgelöst, wenn der summarizeStreaming()-Aufruf aus irgendeinem anderen Grund fehlschlug, oder aus einem Grund, den der Benutzeragent nicht offenlegen wollte.

Beispiele

Grundlegende Nutzung von summarizeStreaming()

const summarizer = await Summarizer.create({
  sharedContext:
    "A general summary to help a user decide if the text is worth reading",
  type: "tldr",
  length: "short",
});

const stream = summarizer.summarizeStreaming(myTextString);
let summary = "";

for await (const chunk of stream) {
  summary += chunk;
}

console.log("Stream complete");
summaryOutput.textContent = summary;

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Verwendung der Summarizer API
• Web AI Demos auf chrome.dev