Rilevamento della lingua con l'AI integrata

AI_USAGE=false

Thomas Steiner

Pubblicato: 24 settembre 2024, ultimo aggiornamento: 20 maggio 2025

Spiegazione	Web	Estensioni	Stato di Chrome	Intenzione
MDN	Chrome 138	Chrome 138	Visualizza	Intenzione di spedizione

Prima di tradurre un testo da una lingua a un'altra, devi prima determinare la lingua utilizzata nel testo specificato. In precedenza, la traduzione richiedeva il caricamento del testo su un servizio cloud, l'esecuzione della traduzione sul server e il download dei risultati.

L'API Language Detector funziona lato client, il che significa che puoi proteggere la privacy degli utenti. Sebbene sia possibile spedire una libreria specifica che lo faccia, richiederebbe risorse aggiuntive da scaricare.

Quando utilizzare il rilevamento della lingua

L'API Language Detector è utile principalmente nei seguenti scenari:

• Determina la lingua del testo di input, in modo che possa essere tradotto.
• Determina la lingua del testo di input, in modo che il modello corretto possa essere caricato per attività specifiche della lingua, come il rilevamento della tossicità.
• Determina la lingua del testo di input, in modo che possa essere etichettato correttamente, ad esempio nei siti di social networking online.
• Determina la lingua del testo di input, in modo che l'interfaccia di un'app possa essere modificata di conseguenza. Ad esempio, su un sito belga, per mostrare solo l'interfaccia pertinente per gli utenti che parlano francese.

Inizia

L'API Language Detector è disponibile a partire dalla versione stabile di Chrome 138. Esegui il rilevamento delle funzionalità per verificare se il browser supporta l'API Language Detector.

if ('LanguageDetector' in self) {
  // The Language Detector API is available.
}

Download modello

Il rilevamento della lingua dipende da un modello ottimizzato per l'attività specifica di rilevamento delle lingue. Sebbene l'API sia integrata nel browser, il modello viene scaricato on demand la prima volta che un sito tenta di utilizzare l'API. In Chrome, questo modello è molto piccolo rispetto ad altri modelli. Potrebbe essere già presente, in quanto questo modello viene utilizzato da altre funzionalità di Chrome.

Per determinare se il modello è pronto per l'uso, chiama la funzione asincrona LanguageDetector.availability(). Se la risposta a availability() è stata downloadable, ascolta l'avanzamento del download e informa l'utente, poiché il download potrebbe richiedere tempo.

const availability = await LanguageDetector.availability();

Per attivare il download e creare un'istanza del rilevatore di lingua, verifica l'attivazione dell'utente. Quindi, chiama la funzione asincrona LanguageDetector.create().

const detector = await LanguageDetector.create({
  monitor(m) {
    m.addEventListener('downloadprogress', (e) => {
      console.log(`Downloaded ${e.loaded * 100}%`);
    });
  },
});

Esegui il rilevatore di lingua

L'API Language Detector utilizza un modello di ranking per determinare la lingua più probabilmente utilizzata in un determinato testo. Il ranking è un tipo di machine learning in cui l'obiettivo è ordinare un elenco di elementi. In questo caso, l'API Language Detector classifica le lingue dalla probabilità più alta a quella più bassa.

La funzione detect() può restituire il primo risultato, la risposta più probabile o iterare sui candidati classificati con il livello di confidenza. Viene restituito come elenco di oggetti {detectedLanguage, confidence}. Il livello di confidence è espresso come un valore compreso tra 0.0 (confidenza più bassa) e 1.0 (confidenza più alta).

const someUserText = 'Hallo und herzlich willkommen!';
const results = await detector.detect(someUserText);
for (const result of results) {
  // Show the full list of potential languages with their likelihood, ranked
  // from most likely to least likely. In practice, one would pick the top
  // language(s) that cross a high enough threshold.
  console.log(result.detectedLanguage, result.confidence);
}
// (Output truncated):
// de 0.9993835687637329
// en 0.00038279531872831285
// nl 0.00010798392031574622
// ...

Playground API

Prova l'API Language Detector nel nostro playground API. Inserisci il testo scritto in lingue diverse nell'area di testo.

Norme relative alle autorizzazioni, iframe e web worker

Per impostazione predefinita, l'API Language Detector è disponibile solo per le finestre di primo livello e per i relativi iframe con stessa origine. L'accesso all'API può essere delegato agli iframe multiorigine utilizzando l'attributo allow="" della policy sui permessi:

<!--
  The hosting site at https://main.example.com can grant a cross-origin iframe
  at https://cross-origin.example.com/ access to the Language Detector API by
  setting the `allow="language-detector"` attribute.
-->
<iframe src="https://cross-origin.example.com/" allow="language-detector"></iframe>

L'API Language Detector non è al momento disponibile nei web worker a causa della complessità di stabilire un documento responsabile per ogni worker al fine di controllare lo stato della policy sulle autorizzazioni.

Impegno di standardizzazione

Stiamo lavorando per standardizzare l'API Language Detector per la compatibilità cross-browser.

L'API Language Detector e l'API Translator sono state adottate dal W3C WebML Working Group. Abbiamo chiesto a Mozilla e WebKit le loro posizioni sugli standard.

Condividi il tuo feedback

Vogliamo vedere cosa stai creando con l'API Language Detector. Condividi i tuoi siti web e applicazioni web con noi su X, YouTube e LinkedIn.

Se hai feedback sull'implementazione di Chrome, segnala un bug di Chromium.