Translator: create() static method

Cú pháp

Translator.create(options)

Tham số

options

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

sourceLanguage

Một chuỗi chỉ định ngôn ngữ dự kiến của văn bản đầu vào cần dịch, phải là BCP 47 language tag hợp lệ.

targetLanguage

Một chuỗi chỉ định ngôn ngữ mà văn bản đầu vào sẽ được dịch sang, phải là BCP 47 language tag hợp lệ.

monitor Optional

Một hàm callback với đối số CreateMonitor cho phép theo dõi tiến trình tải xuống mô hình AI.

signal Optional

Một đối tượng AbortSignal, cho phép hủy thao tác create() qua AbortController liên kết. Hiệu ứng chính xác phụ thuộc vào thời điểm AbortController.abort() được gọi:

• Nếu abort() được gọi trước khi promise create() giải quyết, thao tác create() sẽ bị hủy.
• Nếu abort() được gọi sau khi promise create() thực hiện, nó có tác dụng tương tự như gọi Translator.destroy(): Các tài nguyên được phân bổ cho đối tượng Translator được giải phóng, và bất kỳ lời gọi phương thức Translator đang diễn ra và tiếp theo sẽ từ chối với AbortError.

Giá trị trả về

Một Promise thực hiện với một đối tượng Translator.

Ngoại lệ

InvalidStateError DOMException

Được ném ra nếu Document của trang chưa hoạt động.

NetworkError DOMException

Được ném ra nếu:

• Mạng không có sẵn để tải xuống mô hình AI.
• Người dùng đã hủy tải xuống mô hình AI.

NotAllowedError DOMException

Được ném ra nếu:

• Việc sử dụng phương thức bị chặn bởi translator Permissions-Policy.
• Người dùng đã chặn tải xuống mô hình AI theo một cách nào đó.
• Phương thức create() không được gọi thông qua transient activation.

NotSupportedError DOMException

Được ném ra nếu:

• Các thẻ ngôn ngữ được chỉ định trong sourceLanguage hoặc targetLanguage không hợp lệ hoặc không được hỗ trợ. Điều này xảy ra nếu sourceLanguage và targetLanguage được chỉ định giống nhau.
• Không có mô hình AI để hỗ trợ kết hợp sourceLanguage và targetLanguage được chỉ định.

OperationError DOMException

Ngoại lệ đa mục đích được ném ra nếu việc tạo Translator thất bại vì bất kỳ lý do nào khác.

Ví dụ

Tạo Translator cơ bản

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

Thông số kỹ thuật

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

Xem thêm

• Sử dụng Translator và Language Detector APIs