Summarizer: Methode summarizeStreaming()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die summarizeStreaming()-Methode der Summarizer-Schnittstelle erzeugt eine neue Zusammenfassung als ReadableStream.

Syntax

js
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 erzeugen.

signal

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

Rückgabewert

Ein ReadableStream, der die erzeugte Zusammenfassung enthält.

Ausnahmen

InvalidStateError DOMException

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

NotAllowedError DOMException

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

NotReadableError DOMException

Wird ausgelöst, wenn die Ausgabe der Zusammenfassung vom User-Agent gefiltert wurde, zum Beispiel weil sie als schädlich, ungenau oder unsinnig erkannt wurde.

NotSupportedError DOMException

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

QuotaExceededError DOMException

Wird ausgelöst, wenn der Zusammenfassungsvorgang das verfügbare inputQuota überschreitet.

UnknownError DOMException

Wird ausgelöst, wenn der summarizeStreaming()-Aufruf aus einem anderen Grund oder einem Grund, den der User-Agent nicht offenlegen wollte, fehlgeschlagen ist.

Beispiele

Grundlegende Nutzung von summarizeStreaming()

js
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

Specification
Writing Assistance APIs
# dom-summarizer-summarizestreaming

Browser-Kompatibilität

Siehe auch