Summarizer

Instance properties

expectedContextLanguages Read only

The languages the context strings should be written in.

expectedInputLanguages Read only

The languages the Summarizer should support.

format Read only

The text format summaries will be returned in.

inputQuota Read only

The input quota available to the browser for generating summaries.

length Read only

The relative length of the generated summaries.

outputLanguage Read only

The language the summary should be generated in.

sharedContext Read only

A text string describing the context the pieces of text to summarize are being used in, which helps the Summarizer generate more suitable summaries.

type Read only

The type of summary that will generated by the Summarizer.

Static methods

availability()

Returns an enumerated value that indicates whether the browser AI model supports a given Summarizer configuration.

create()

Creates a new Summarizer instance from which to generate summaries.

Instance methods

destroy()

Releases the resources assigned to the Summarizer instance it is called on and stops any further activity on it.

measureInputUsage()

Reports how much input quota would be used by a summarize operation for a given text input.

summarize()

Generates a new summary string.

summarizeStreaming()

Generates a new summary as a ReadableStream.

Examples

See Using the Summarizer API for a complete example.

Creating a Summarizer instance

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",
});

Generating a summary

const summary = await summarizer.summarize(myTextString);
console.log(summary);

Generating a summary stream

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

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

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

Specifications

Browser compatibility

See also

• Using the Summarizer API
• Web AI demos on chrome.dev