Summarizer: summarize() Methode

Syntax

summarize(input)
summarize(input, options)

Parameter

input

Ein String, der den zu zusammenfassenden Text darstellt.

options Optional

Ein Objekt, das Konfigurationsoptionen für den summarize() Vorgang spezifiziert. Mögliche Werte sind:

context

Ein String, der den Kontext beschreibt, in dem der eingehende Text verwendet wird. Dies hilft dem Summarizer, eine passendere Zusammenfassung zu erzeugen.

signal

Eine Instanz des AbortSignal Objekts, die es ermöglicht, den summarize() Vorgang über den zugehörigen AbortController abzubrechen.

Rückgabewert

Ein Promise, das mit einem String erfüllt wird, der die erzeugte Zusammenfassung enthält.

Ausnahmen

AbortError DOMException

Wird ausgelöst, wenn der Summarizer zuvor zerstört wurde (z. B. wurde Summarizer.destroy() aufgerufen oder es wurde über das Abbruch-signal nach der Erstellung abgebrochen).

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 wird.

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 Sprache ist, die der Summarizer unterstützt.

QuotaExceededError

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

UnknownError DOMException

Wird ausgelöst, wenn der summarize() Aufruf aus einem anderen Grund fehlschlägt, oder aus einem Grund, den der Benutzeragent nicht offenlegen möchte.

Beispiele

Grundlegende summarize() Nutzung

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 summary = await summarizer.summarize(myTextString);
console.log(summary);

Spezifikationen

Browser-Kompatibilität

Siehe auch

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