Taaldetectie met ingebouwde AI

Thomas Steiner

Gepubliceerd: 24 september 2024, laatst geüpdatet: 20 mei 2025

Voordat je tekst van de ene naar de andere taal vertaalt, moet je eerst bepalen welke taal wordt gebruikt in de tekst. Eerder moest je voor vertalingen de tekst uploaden naar een cloudservice, de vertaling op de server uitvoeren en de resultaten downloaden.

De Language Detector API werkt aan de clientzijde, wat betekent dat je de privacy van gebruikers kunt beschermen. Het is mogelijk om een specifieke bibliotheek te leveren die dit doet, maar hiervoor zijn extra bronnen nodig om te downloaden.

Wanneer je taaldetectie gebruikt

De Language Detector API is vooral nuttig in de volgende scenario's:

• De taal van de invoertekst bepalen, zodat deze kan worden vertaald.
• Bepaal de taal van de invoertekst, zodat het juiste model kan worden geladen voor taalspecifieke taken, zoals detectie van schadelijke content.
• De taal van invoertekst bepalen, zodat deze correct kan worden gelabeld, bijvoorbeeld op online sociale netwerksites.
• De taal van de invoertekst bepalen, zodat de interface van een app kan worden aangepast. Bijvoorbeeld op een Belgische site om alleen de interface te tonen die relevant is voor gebruikers die Frans spreken.

Aan de slag

De Language Detector API en Translator API werken in Chrome op desktops. Deze API's werken niet op mobiele apparaten.

Voer functiedetectie uit om te controleren of de browser de Language Detector API ondersteunt.

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

Model downloaden

Taaldetectie is afhankelijk van een model dat is afgestemd op de specifieke taak om talen te detecteren. Hoewel de API is ingebouwd in de browser, wordt het model on demand gedownload de eerste keer dat een site de API probeert te gebruiken. In Chrome is dit model erg klein in vergelijking met andere modellen. Het is misschien al aanwezig, omdat dit model wordt gebruikt door andere Chrome-functies.

Roep de asynchrone functie LanguageDetector.availability() aan om te bepalen of het model klaar is voor gebruik. Als de reactie op availability() downloadable was, luister je naar de downloadvoortgang en informeer je de gebruiker, omdat de download even kan duren.

Als je de download wilt activeren en de taaldetector wilt instantiëren, controleer je op gebruikersactivering. Roep daarna de asynchrone functie LanguageDetector.create() aan.

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

De taaldetector uitvoeren

De Language Detector API gebruikt een rangschikkingsmodel om te bepalen welke taal het meest waarschijnlijk wordt gebruikt in een bepaald stuk tekst. Rangschikking is een type machine learning waarbij het doel is om een lijst met items te ordenen. In dit geval rangschikt de Language Detector API de talen van de hoogste naar de laagste waarschijnlijkheid.

De functie detect() kan het eerste resultaat of het meest waarschijnlijke antwoord retourneren, of de gerangschikte kandidaten doorlopen met het betrouwbaarheidsniveau. Dit wordt geretourneerd als een lijst met {detectedLanguage, confidence}-objecten. Het niveau van confidence wordt uitgedrukt als een waarde tussen 0.0 (laagste betrouwbaarheid) en 1.0 (hoogste betrouwbaarheid).

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

API-playground

Experimenteer met de Language Detector API in onze API-playground. Voer tekst in verschillende talen in het tekstgebied in.

Rechtenbeleid, iframes en web workers

De Language Detector API is standaard alleen beschikbaar voor vensters op het hoogste niveau en voor hun same-origin iframes. Toegang tot de API kan worden gedelegeerd aan cross-origin iframes met het kenmerk Permission Policy allow="":

<!--
  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>

De Language Detector API is niet beschikbaar in Web Workers. Dit komt door de complexiteit van het opstellen van een verantwoordelijk document voor elke werknemer om de Beleidsstatus voor rechten te controleren.

Je feedback delen

We willen graag zien wat je maakt met de Language Detector API. Deel je websites en web-apps met ons op X, YouTube en LinkedIn.

Als je feedback hebt over de implementatie van Chrome, dien je een Chromium-bug in.

Neem deel aan het Early Preview Program voor een vroege blik op nieuwe ingebouwde AI-API's en toegang tot discussies op onze mailinglijst.