LanguageDetector: phương thức measureInputUsage()

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 measureInputUsage() của giao diện LanguageDetector báo cáo lượng hạn ngạch đầu vào sẽ được sử dụng bởi một thao tác phát hiện ngôn ngữ cho đầu vào văn bản đã cho.

Cú pháp

measureInputUsage(input)
measureInputUsage(input, options)

Tham số

input

Một chuỗi đại diện cho văn bản đầu vào bạn muốn đo lường mức sử dụng đầu vào.

options Optional

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

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

Giá trị trả về

Một Promise hoàn thành với một số chỉ định mức sử dụng inputQuota của văn bản đầu vào đã cho.

Số này phụ thuộc vào triển khai; nếu nó nhỏ hơn inputQuota, ngôn ngữ của chuỗi có thể được phát hiện.

Ngoại lệ

NotAllowedError DOMException: Được ném nếu việc sử dụng API LanguageDetector bị chặn bởi language-detector Permissions-Policy.
UnknownError DOMException: Được ném nếu cuộc gọi measureInputUsage() 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ộ.

Trong đoạn mã dưới đây, chúng ta tạo một phiên bản LanguageDetector mới bằng create(), sau đó trả về tổng hạn ngạch đầu vào qua inputQuota và mức sử dụng hạn ngạch đầu vào để phát hiện ngôn ngữ của một chuỗi văn bản cụ thể qua measureInputUsage().

Sau đó chúng ta kiểm tra xem mức sử dụng đầu vào riêng lẻ cho chuỗi đó có lớn hơn tổng hạn ngạch có sẵn không. Nếu vậy, chúng ta ném một lỗi thích hợp; nếu không, chúng ta bắt đầu phát hiện ngôn ngữ của chuỗi bằng detect().

const detector = await LanguageDetector.create({
  expectedInputLanguages: ["en-US", "zh"],
});

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

if (inputUsage > totalInputQuota) {
  throw new Error("Insufficient quota to detect languages.");
} else {
  console.log("Quota available to detect languages.");
  const results = await detector.detect(myTextString);
  // ...
}