LanguageDetector: phương thức tĩnh create()

Cú pháp

LanguageDetector.create(options)

Tham số

options

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

expectedInputLanguages

Một mảng các chuỗi chỉ định các ngôn ngữ dự kiến của văn bản đầu vào, giúp cải thiện độ chính xác của việc phát hiện ngôn ngữ. Đây phải là các thẻ ngôn ngữ BCP 47 hợp lệ. Mặc định là ["en"].

monitor Optional

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

signal Optional

Một phiên bản đối tượng AbortSignal, cho phép hủy bỏ thao tác create() thông 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() hoàn thành, nó có tác dụng tương tự như gọi LanguageDetector.destroy(): Các tài nguyên được gán cho phiên bản LanguageDetector kết quả được giải phóng, và bất kỳ lệnh gọi phương thức LanguageDetector đang diễn ra và tiếp theo sẽ từ chối với AbortError.

Giá trị trả về

Một Promise hoàn thành với một phiên bản đối tượng LanguageDetector.

Ngoại lệ

InvalidStateError DOMException

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

NetworkError DOMException

Được ném nếu:

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

NotAllowedError DOMException

Được ném nếu:

• Việc sử dụng phương thức bị chặn bởi language-detector Permissions-Policy.
• Người dùng đã chặn việc 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 nếu:

• Các thẻ ngôn ngữ được chỉ định trong expectedInputLanguages không hợp lệ hoặc không được hỗ trợ.
• Mô hình AI để hỗ trợ expectedInputLanguages đã chỉ định không có sẵn.

OperationError DOMException

Ngoại lệ đa năng được ném nếu việc tạo LanguageDetector thất bại vì bất kỳ lý do nào khác.

Ví dụ

Tạo LanguageDetector cơ bản

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

Thông số kỹ thuật

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

Xem thêm

• Sử dụng Translator and Language Detector APIs