---
title: i18n
slug: Mozilla/Add-ons/WebExtensions/API/i18n
tags:
  - API
  - Add-ons
  - Extensions
  - Interface
  - Non-standard
  - Reference
  - WebExtensions
  - i18n
translation_of: Mozilla/Add-ons/WebExtensions/API/i18n
---
<div>{{AddonSidebar}}</div>

<p>Fonctions permettant d'internationaliser votre extension. Vous pouvez utiliser ces API pour obtenir des chaînes localisées à partir de fichiers locaux conditionnés avec votre extension, connaître la langue actuelle du navigateur et en connaître la valeur de son <a href="/fr/docs/Web/HTTP/Content_negotiation#The_Accept-Language_header">En-tete "Accept-Language"</a>.</p>

<p id="See_also">Pour plus de détails sur l'utilisation de i18n pour votre extension, voir :</p>

<ul>
 <li><a href="/fr/Add-ons/WebExtensions/Internationalization">Internationalization</a>: un guide d'utilisation du système WebExtension i18n.</li>
 <li><a href="/fr/Add-ons/WebExtensions/API/i18n/Locale-Specific_Message_reference">Référence de message spécifique aux paramètres régionaux </a>: Les extensions fournissent des chaînes de caractères locales dans des fichiers appelés <code>messages.json</code>. Cette page décrit le format de <code>messages.json</code>.</li>
</ul>

<h2 id="Types">Types</h2>

<dl>
 <dt>{{WebExtAPIRef("i18n.LanguageCode")}}</dt>
 <dd>Une <a href="https://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.10">balise de langue</a> telle que <code>"en-US"</code> ou "<code>fr</code>".</dd>
</dl>

<h2 id="Fonctions">Fonctions</h2>

<dl>
 <dt>{{WebExtAPIRef("i18n.getAcceptLanguages()")}}</dt>
 <dd>Obtient les <a href="/fr/docs/Web/HTTP/Content_negotiation#The_Accept-Language_header">accept-languages</a> du navigateur. Ceci est différent des paramètres régionaux utilisés par le navigateur. Pour obtenir les paramètres régionaux, utilisez  {{WebExtAPIRef('i18n.getUILanguage')}}.</dd>
 <dt>{{WebExtAPIRef("i18n.getMessage()")}}</dt>
 <dd>Obtient la chaîne localisée pour le message spécifié.</dd>
 <dt>{{WebExtAPIRef("i18n.getUILanguage()")}}</dt>
 <dd>Obtient la langue de l'interface utilisateur du navigateur. Ceci est différent de  {{WebExtAPIRef('i18n.getAcceptLanguages')}} qui renvoie les langues utilisateur préférées.</dd>
 <dt>{{WebExtAPIRef("i18n.detectLanguage()")}}</dt>
 <dd>Détecte la langue du texte fourni en utilisant le <a href="https://github.com/CLD2Owners/cld2">détecteur de langue compact</a>.</dd>
</dl>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<p>{{Compat("webextensions.api.i18n")}}</p>

<p>{{WebExtExamples("h2")}}</p>

<div class="blockIndicator note">
<p><strong>Remerciements</strong><br>
 Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/i18n"><code>chrome.i18n</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/i18n.json"><code>i18n.json</code></a> dans le code de Chromium.<br>
 <br>
 Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p>
</div>