Summarizer: phương thức summarize()

Limited availability

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

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Phương thức summarize() của giao diện Summarizer tạo một chuỗi bản tóm tắt mới.

Cú pháp

js
summarize(input)
summarize(input, options)

Tham số

input

Một chuỗi đại diện cho văn bản cần tóm tắt.

options Optional

Một đối tượng xác định các tùy chọn cấu hình cho thao tác summarize(). Các giá trị có thể bao gồm:

context

Một chuỗi mô tả ngữ cảnh mà văn bản đầu vào đang được sử dụng trong đó, giúp Summarizer tạo ra bản tóm tắt phù hợp hơn.

signal

Một thực thể đối tượng AbortSignal, cho phép hủy bỏ thao tác summarize() thông qua AbortController được liên kết.

Giá trị trả về

Một Promise được giải quyết với một chuỗi chứa bản tóm tắt được tạo.

Ngoại lệ

AbortError DOMException

Được ném ra nếu Summarizer trước đó đã bị hủy bỏ (đã gọi Summarizer.destroy() hoặc bị hủy bỏ thông qua signal hủy bỏ sau khi tạo).

InvalidStateError DOMException

Được ném ra nếu Document hiện tại không hoạt động.

NotAllowedError DOMException

Được ném ra nếu việc sử dụng Summarizer API bị chặn bởi summarizer Permissions-Policy.

NotReadableError DOMException

Được ném ra nếu bản tóm tắt đầu ra bị lọc bởi tác nhân người dùng, ví dụ vì nó bị phát hiện là có hại, không chính xác hoặc vô nghĩa.

NotSupportedError DOMException

Được ném ra nếu context được cung cấp không ở ngôn ngữ mà Summarizer hỗ trợ.

QuotaExceededError

Được ném ra nếu thao tác tóm tắt vượt quá inputQuota có sẵn.

UnknownError DOMException

Được ném ra nếu lần gọi summarize() thất bại vì bất kỳ lý do nào khác, hoặc lý do mà tác nhân người dùng không muốn tiết lộ.

Ví dụ

Sử dụng cơ bản summarize()

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

Thông số kỹ thuật

Specification
Writing Assistance APIs
# dom-summarizer-summarize

Tương thích trình duyệt

Xem thêm