Rilevamento della lingua con l'AI integrata

Thomas Steiner

Data di pubblicazione: 24 settembre 2024, Ultimo aggiornamento: 20 maggio 2025

Browser Support

• 138
• 148
• x
• x

Source

Prima di tradurre il testo da una lingua all'altra, devi determinare quale lingua viene 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 fornire una libreria specifica che esegua questa operazione, il download richiederebbe risorse aggiuntive.

Quando utilizzare il rilevamento della lingua

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

• Determinare la lingua del testo di input in modo che possa essere tradotto.
• Determinare la lingua del testo di input, in modo da poter caricare il modello corretto per le attività specifiche della lingua, come il rilevamento della tossicità.
• Determinare la lingua del testo di input, in modo che possa essere etichettato correttamente, ad esempio nei siti di social networking online.
• Determinare 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

Le API Language Detector e Translator funzionano in Chrome su computer. Queste API non funzionano sui dispositivi mobili.

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.
}

Suggerimento: utilizza il pacchetto npm @types/dom-chromium-ai per ottenere i tipi TypeScript per l'API Prompt e altre API di AI integrate per un accesso più semplice nel tuo codebase.

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, poiché 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 del tempo.

Per attivare il download e creare un'istanza del rilevatore di lingua, verifica l'attivazione dell'utente. Poi, 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 della lingua

L'API Language Detector utilizza un modello di ranking per determinare quale lingua è più probabile che venga 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.

Nota: l'API Language Detector è addestrata su un insieme di lingue, che non include tutte le lingue esistenti. Ciò significa che l'API non può rilevare ogni lingua con assoluta precisione. A partire da Chrome 132, puoi verificare se una determinata lingua è disponibile per il rilevamento.

La funzione detect() può restituire il primo risultato, la risposta più probabile o eseguire l'iterazione dei candidati classificati con il livello di confidenza. Viene restituito un elenco di oggetti {detectedLanguage, confidence}. Il livello 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
// ...

Attenzione: evita frasi molto brevi e singole parole, poiché l'accuratezza dei risultati sarà bassa. Se lavori spesso con testi più brevi, sperimenta con le tue lingue prioritarie, esamina l'affidabilità segnalata e restituisci il risultato come sconosciuto quando l'affidabilità è troppo bassa.

API Playground

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

Policy sulle 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 a iframe multiorigine utilizzando l'attributo allow="" della policy sulle autorizzazioni:

<!--
  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 è disponibile nei web worker. Ciò è dovuto alla complessità di stabilire un documento responsabile per ogni worker al fine di controllare lo stato secondo le norme della policy Permissions-Policy.

Condividi il tuo feedback

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

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

Partecipa al programma di anteprima per dare un'occhiata in anteprima alle nuove API AI integrate e accedere alla discussione nella nostra mailing list.