LanguageDetector: create() static method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("Translator and Language Detector APIs")}}{{SeeCompatTable}}{{securecontext_header}}
The **create()** static method of the {{domxref("LanguageDetector")}} interface creates a new LanguageDetector instance to detect languages.
توجه: The create() method requires transient activation, that is, it must be invoked in response to a user action such as a mouse click or button press.
Syntax
js-nolint
LanguageDetector.create(options)Parameters
options- : An object specifying configuration options for the
LanguageDetector. Possible values include: expectedInputLanguages- : An array of strings specifying the expected languages of the input text, which helps improve the accuracy of the language detection. These should be valid {{glossary("BCP 47 language tag", "BCP 47 language tags")}}. Defaults to
["en"]. monitor{{optional_inline}}- : A callback function with a {{domxref("CreateMonitor")}} argument that enables monitoring download progress of the AI model.
signal{{optional_inline}}- : An {{domxref("AbortSignal")}} object instance, which allows a
create()operation to be aborted via the associated {{domxref("AbortController")}}. The exact effect is dependent on when {{domxref("AbortController.abort()")}} is called: - If
abort()is called before thecreate()promise resolves, thecreate()operation is canceled. - If
abort()is called after thecreate()promise fulfills, it has the same effect as calling {{domxref("LanguageDetector.destroy()")}}: The resources assigned to the resultingLanguageDetectorinstance are released, and any ongoing and subsequentLanguageDetectormethod calls will reject with anAbortError.
Return value
A {{jsxref("Promise")}} that fulfills with a LanguageDetector object instance.
Exceptions
InvalidStateError{{domxref("DOMException")}}- : Thrown if the page's {{domxref("Document")}} is not yet active.
NetworkError{{domxref("DOMException")}}- : Thrown if:
- The network was not available to download the AI model.
- The user has canceled the AI model download.
NotAllowedError{{domxref("DOMException")}}- : Thrown if:
- Usage of the method is blocked by a {{httpheader('Permissions-Policy/language-detector','language-detector')}} {{httpheader("Permissions-Policy")}}.
- The user has blocked the AI model download in some way.
- The
create()method wasn't called via {{glossary("transient activation")}}. NotSupportedError{{domxref("DOMException")}}- : Thrown if:
- The language tags specified in
expectedInputLanguagesare invalid, or not supported. - An AI model to support the specified
expectedInputLanguagesis not available. OperationError{{domxref("DOMException")}}- : General-purpose exception thrown if
LanguageDetectorcreation failed for any other reason.
Examples
Basic LanguageDetector creation
js
const detector = await LanguageDetector.create({
expectedInputLanguages: ["en-US", "zh"],
});Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- Using the Translator and Language Detector APIs