Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Summarizer: create() statische Methode

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 create() statische Methode der Summarizer Schnittstelle erstellt eine neue Summarizer-Instanz, um Zusammenfassungen zu generieren.

Hinweis: Die create()-Methode erfordert transiente Aktivierung, das heißt, sie muss als Reaktion auf eine Benutzeraktion wie einen Mausklick oder Tastendruck aufgerufen werden.

Syntax

js
Summarizer.create()
Summarizer.create(options)

Parameter

options Optional

Ein Objekt, das Konfigurationsoptionen für den Summarizer angibt. Mögliche Werte sind:

expectedInputLanguages

Ein Array von Strings, das die erwarteten Sprachen des Eingabetexts spezifiziert, die gültige BCP 47 Sprach-Tags sein sollten. Standardmäßig ["en"].

expectedContextLanguages

Ein Array von Strings, das die erwarteten Sprachen aller bereitgestellten Kontext-Strings spezifiziert (entweder der sharedContext, der dem Summarizer übergeben wurde, oder ein context, das während eines summarize()- oder summarizeStreaming()-Aufrufs spezifiziert wurde), die gültige BCP 47 Sprach-Tags sein sollten. Standardmäßig ["en"].

format

Ein enumerierter Wert, der das Textformat angibt, in dem Sie Zusammenfassungen erhalten möchten. Standardmäßig markdown.

length

Ein enumerierter Wert, der die relative length für die generierten Zusammenfassungen angibt. Standardmäßig short.

monitor

Eine Callback-Funktion mit einem CreateMonitor-Argument, die es ermöglicht, den Download-Fortschritt des KI-Modells zu überwachen.

outputLanguage

Ein String, der die erwartete Sprache der vom Summarizer generierten Zusammenfassungen angibt, die ein gültiges BCP 47 Sprach-Tag sein sollte. Standardmäßig en.

sharedContext

Ein sharedContext String, der den Kontext beschreibt, in dem die zusammenzufassenden Texte verwendet werden, was dem Summarizer hilft, geeignetere Zusammenfassungen zu generieren.

signal

Ein AbortSignal Objekt, das es ermöglicht, die create()-Operation über den assoziierten AbortController abzubrechen.

type

Ein enumerierter Wert, der die type der Zusammenfassung angibt, die dieser Summarizer generieren soll. Standardmäßig key-points.

Rückgabewert

Ein Promise, das mit einer Summarizer-Objektinstanz erfüllt wird.

Ausnahmen

NotAllowedError DOMException

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

NotSupportedError DOMException

Wird ausgelöst, wenn eines der in expectedContextLanguages, expectedInputLanguages oder outputLanguage angegebenen Sprach-Tags ungültig oder nicht unterstützt ist.

OperationError DOMException

Allgemeine Ausnahme, die ausgelöst wird, wenn die Erstellung des Summarizer aus einem anderen Grund fehlschlug.

Beispiele

Grundlegende Erstellung eines Summarizer

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",
  format: "markdown",
  expectedInputLanguages: ["en-US"],
  outputLanguage: "en-US",
});

Spezifikationen

Specification
Writing Assistance APIs
# dom-summarizer-create

Browser-Kompatibilität

Siehe auch