Translator: measureInputUsage() method

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 Translator báo cáo mức hạn mức đầu vào sẽ được sử dụng bởi một thao tác dịch cho một văn bản đầu vào nhất định.

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 mà 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 đối tượng AbortSignal, cho phép hủy thao tác measureInputUsage() qua AbortController liên kết.

Giá trị trả về

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

Con số này phụ thuộc vào triển khai; nếu nó nhỏ hơn inputQuota, chuỗi có thể được dịch.

Ngoại lệ

NotAllowedError DOMException: Được ném ra nếu việc sử dụng Translator API bị chặn bởi translator Permissions-Policy.
NotReadableError DOMException: Được ném ra nếu bản dịch đầu ra bị lọc bởi user agent, ví dụ vì nó được phát hiện là có hại, không chính xác hoặc vô nghĩa.
UnknownError DOMException: Được ném ra nếu lời gọi measureInputUsage() thất bại vì bất kỳ lý do nào khác, hoặc vì lý do mà user agent không muốn tiết lộ.

Trong đoạn mã dưới đây, chúng ta tạo một đối tượng Translator mới bằng create(), sau đó trả về tổng hạn mức đầu vào qua inputQuota và mức sử dụng hạn mức đầu vào cho việc dịch 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 mức có sẵn không. Nếu có, chúng ta ném ra lỗi phù hợp; nếu không, chúng ta bắt đầu dịch chuỗi bằng translate().

const translator = await Translator.create({
  sourceLanguage: "en",
  targetLanguage: "ja",
});

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

if (inputUsage > totalInputQuota) {
  throw new Error("Insufficient quota to translate.");
} else {
  console.log("Quota available to translate.");
  const translation = await translator.translate(myTextString);
  // ...
}