Summarizer: inputQuota-Eigenschaft

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

Die schreibgeschützte inputQuota-Eigenschaft der Summarizer-Schnittstelle gibt das verfügbare Eingabe-Kontingent zurück, das dem Browser für das Erstellen von Zusammenfassungen zur Verfügung steht.

Wert

Eine Zahl, die das verfügbare Eingabe-Kontingent angibt. Diese Zahl ist abhängig von der Implementierung. Zum Beispiel könnte es infinity sein, wenn es keine anderen Grenzen außer dem Speicher des Benutzers und der maximalen Länge von JavaScript-Strings gibt, oder es könnte eine Anzahl von Tokens sein im Fall von KI-Modellen, die ein Token-/Credits-Schema verwenden.

Beispiele

Überprüfen, ob ausreichend Kontingent vorhanden ist

Im folgenden Code-Snippet erstellen wir eine neue Summarizer-Instanz mit create(), dann geben wir das gesamte Eingabe-Kontingent über inputQuota sowie die Eingabe-Kontingentnutzung für die Zusammenfassung eines bestimmten Textstrings mit measureInputUsage() zurück.

Anschließend prüfen wir, ob die individuelle Eingabenutzung für diesen String größer ist als das insgesamt verfügbare Kontingent. Falls ja, werfen wir einen entsprechenden Fehler; falls nicht, beginnen wir mit der Zusammenfassung des Strings mit summarize().

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

const totalInputQuota = summarizer.inputQuota;
const inputUsage = await summarizer.measureInputUsage(myTextString);

if (inputUsage > totalInputQuota) {
  throw new Error("Boo, insufficient quota to generate a summary.");
} else {
  console.log("Yay, quota available to generate a summary.");
  const summary = await summarizer.summarize(myTextString);
  // ...
}

Spezifikationen

Specification
Writing Assistance APIs
# dom-summarizer-inputquota

Browser-Kompatibilität

Siehe auch