Chrome अब स्टैंडर्ड browser.* नेमस्पेस के साथ काम करता है. यह Chrome 148 से उपलब्ध है. हम दस्तावेज़ को धीरे-धीरे अपडेट कर रहे हैं. ज़्यादा जानकारी के लिए, हमारी ट्रांज़िशन गाइड पढ़ें.

Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

browser.i18n

ब्यौरा

अपने पूरे ऐप्लिकेशन या एक्सटेंशन में, इंटरनैशनलाइज़ेशन को लागू करने के लिए, chrome.i18n इन्फ़्रास्ट्रक्चर का इस्तेमाल करें.

मेनिफ़ेस्ट

अगर किसी एक्सटेंशन में /_locales डायरेक्ट्री है, तो मेनिफ़ेस्ट में "default_locale" को तय करना ज़रूरी है.

कॉन्सेप्ट और इस्तेमाल

आपको उपयोगकर्ता को दिखने वाली सभी स्ट्रिंग को messages.json नाम की फ़ाइल में डालना होगा. हर बार जब आप कोई नया स्थान-भाषा जोड़ते हैं, तो आप /_locales/_localeCode_ नाम की डायरेक्ट्री के तहत एक संदेश फ़ाइल जोड़ते हैं, जहां localeCode अंग्रेज़ी के लिए en जैसा कोड होता है.

यहां अंग्रेज़ी (en), स्पैनिश (es), और कोरियन (ko) भाषा के साथ काम करने वाले, अंतरराष्ट्रीय स्तर पर उपलब्ध एक्सटेंशन के लिए फ़ाइल हैरारकी दी गई है:

एक्सटेंशन डायरेक्ट्री में: manifest.json, *.html, *.js, /_locales डायरेक्ट्री. /_locales डायरेक्ट्री में: en, es, और ko डायरेक्ट्री, जिनमें से हर एक में messages.json फ़ाइल होती है.

कई भाषाओं में उपलब्ध है

मान लें कि आपके पास एक एक्सटेंशन है, जिसमें यहां दी गई इमेज में दिखाई गई फ़ाइलें हैं:

एक manifest.json फ़ाइल और JavaScript वाली एक फ़ाइल. .json फ़ाइल में 'नमस्ते' लिखा है. JavaScript फ़ाइल में title = 'Hello World' है.

इस एक्सटेंशन को अंतरराष्ट्रीय स्तर पर उपलब्ध कराने के लिए, उपयोगकर्ता को दिखने वाली हर स्ट्रिंग को नाम दें और उसे मैसेज फ़ाइल में डालें. एक्सटेंशन का मेनिफ़ेस्ट, सीएसएस फ़ाइलें, और JavaScript कोड, हर स्ट्रिंग के नाम का इस्तेमाल करके, उसका स्थानीय भाषा में उपलब्ध वर्शन हासिल करते हैं.

अंतरराष्ट्रीय स्तर पर उपलब्ध होने के बाद, एक्सटेंशन ऐसा दिखता है. ध्यान दें कि इसमें अब भी सिर्फ़ अंग्रेज़ी स्ट्रिंग हैं:

manifest.json फ़ाइल में, 'Hello World' को बदलकर '__MSG_extName__' कर दिया गया है. साथ ही, नए default_locale' आइटम की वैल्यू 'en' है. JavaScript फ़ाइल में, 'नमस्ते' को बदलकर browser.i18n.getMessage('extName') कर दिया गया है. /_locales/en/messages.json नाम की एक नई फ़ाइल, 'extName' को तय करती है.

अंतरराष्ट्रीय स्तर पर उपलब्ध कराने के बारे में कुछ ज़रूरी बातें:

इस्तेमाल की जा सकने वाली किसी भी स्थान-भाषा का इस्तेमाल किया जा सकता है. अगर ऐसी भाषा का इस्तेमाल किया जाता है जो काम नहीं करती, तो Google Chrome उसे अनदेखा कर देता है.
manifest.json और सीएसएस फ़ाइलों में, messagename नाम की स्ट्रिंग को इस तरह रेफ़र करें:
```
__MSG_messagename__
```
अपने एक्सटेंशन या ऐप्लिकेशन के JavaScript कोड में, messagename नाम की स्ट्रिंग को इस तरह रेफ़र करें:
```
browser.i18n.getMessage("messagename")
```
getMessage() को किए जाने वाले हर कॉल में, मैसेज में शामिल करने के लिए ज़्यादा से ज़्यादा नौ स्ट्रिंग दी जा सकती हैं. ज़्यादा जानकारी के लिए, उदाहरण: getMessage देखें.
@@bidi_dir और @@ui_locale जैसे कुछ मैसेज, इंटरनैशनलाइज़ेशन सिस्टम से मिलते हैं. पहले से तय किए गए मैसेज के नामों की पूरी सूची देखने के लिए, पहले से तय किए गए मैसेज सेक्शन देखें.
messages.json में, उपयोगकर्ता को दिखने वाली हर स्ट्रिंग का एक नाम, एक "मैसेज" आइटम, और एक वैकल्पिक "जानकारी" आइटम होता है. नाम एक कुंजी है, जैसे कि "extName" या "search_string", जो स्ट्रिंग की पहचान करती है. "message" से, इस स्थान-भाषा में स्ट्रिंग की वैल्यू तय होती है. वैकल्पिक "ब्यौरा" अनुवादकों को मदद उपलब्ध कराता है, जो शायद यह न देख पाएं कि आपके एक्सटेंशन में स्ट्रिंग का इस्तेमाल कैसे किया जाता है. उदाहरण के लिए:
```
{
  "search_string": {
    "message": "hello%20world",
    "description": "The string we search for. Put %20 between words that go together."
  },
  ...
}
```

ज़्यादा जानकारी के लिए, फ़ॉर्मैट: स्थान-विशिष्ट संदेश देखें.

एक्सटेंशन को अंतरराष्ट्रीय स्तर पर उपलब्ध कराने के बाद, उसका अनुवाद करना आसान हो जाता है. messages.json को कॉपी करें, उसका अनुवाद करें, और कॉपी को /_locales में मौजूद नई डायरेक्ट्री में डालें. उदाहरण के लिए, स्पैनिश भाषा में अनुवाद करने के लिए, messages.json की अनुवाद की गई कॉपी को /_locales/es में डालें. नीचे दी गई इमेज में, स्पैनिश में अनुवाद किए गए नए एक्सटेंशन के साथ पिछला एक्सटेंशन दिखाया गया है.

यह पिछली इमेज जैसी ही दिखती है. हालांकि, इसमें /_locales/es/messages.json पर एक नई फ़ाइल है, जिसमें मैसेज का स्पैनिश अनुवाद शामिल है.

पहले से तय मैसेज

इंटरनैशनलाइज़ेशन सिस्टम, पहले से तय किए गए कुछ मैसेज उपलब्ध कराता है. इनकी मदद से, एक्सटेंशन को स्थानीय भाषा में उपलब्ध कराया जा सकता है. इनमें @@ui_locale शामिल है, ताकि आप मौजूदा यूज़र इंटरफ़ेस (यूआई) की भाषा का पता लगा सकें. साथ ही, इनमें कुछ @@bidi_... मैसेज भी शामिल हैं, जिनसे आपको टेक्स्ट की दिशा का पता चलता है. बाद वाले मैसेज के नाम, गैजेट बीआईडीआई (बाय-डायरेक्शनल) एपीआई में मौजूद कॉन्स्टेंट के नामों से मिलते-जुलते हैं.

खास मैसेज @@extension_id का इस्तेमाल, सीएसएस और JavaScript फ़ाइलों में किया जा सकता है. भले ही, एक्सटेंशन या ऐप्लिकेशन को स्थानीय भाषा में उपलब्ध कराया गया हो या नहीं. यह मैसेज, मेनिफ़ेस्ट फ़ाइलों में काम नहीं करता.

यहां दी गई टेबल में, पहले से तय किए गए हर मैसेज के बारे में बताया गया है.

मैसेज का नाम	ब्यौरा
`@@extension_id`	एक्सटेंशन या ऐप्लिकेशन आईडी; इस स्ट्रिंग का इस्तेमाल, एक्सटेंशन में मौजूद संसाधनों के लिए यूआरएल बनाने के लिए किया जा सकता है. जिन एक्सटेंशन को स्थानीय भाषा में उपलब्ध नहीं कराया गया है वे भी इस मैसेज का इस्तेमाल कर सकते हैं. ध्यान दें: इस मैसेज का इस्तेमाल मेनिफ़ेस्ट फ़ाइल में नहीं किया जा सकता.
`@@ui_locale`	मौजूदा स्थान-भाषा; स्थान-भाषा के हिसाब से यूआरएल बनाने के लिए, इस स्ट्रिंग का इस्तेमाल किया जा सकता है.
`@@bidi_dir`	मौजूदा स्थान-भाषा के लिए टेक्स्ट की दिशा. यह अंग्रेज़ी जैसी बाएं से दाएं लिखी जाने वाली भाषाओं के लिए "ltr" या अरबी जैसी दाएं से बाएं लिखी जाने वाली भाषाओं के लिए "rtl" हो सकती है.
`@@bidi_reversed_dir`	अगर `@@bidi_dir` "ltr" है, तो यह "rtl" है; नहीं तो, यह "ltr" है.
`@@bidi_start_edge`	अगर `@@bidi_dir` "ltr" है, तो यह "left" है; नहीं तो, यह "right" है.
`@@bidi_end_edge`	अगर `@@bidi_dir` "ltr" है, तो यह "right" है; नहीं तो, यह "left" है.

यूआरएल बनाने के लिए, सीएसएस फ़ाइल में @@extension_id का इस्तेमाल करने का उदाहरण यहां दिया गया है:

body {
  background-image:url('chrome-extension://__MSG_@@extension_id__/background.png');
}

अगर एक्सटेंशन आईडी abcdefghijklmnopqrstuvwxyzabcdef है, तो पिछले कोड स्निपेट में बोल्ड लाइन यह बन जाती है:

  background-image:url('chrome-extension://abcdefghijklmnopqrstuvwxyzabcdef/background.png');

यहां सीएसएस फ़ाइल में @@bidi_* मैसेज इस्तेमाल करने का उदाहरण दिया गया है:

body {
  direction: __MSG_@@bidi_dir__;
}

div#header {
  margin-bottom: 1.05em;
  overflow: hidden;
  padding-bottom: 1.5em;
  padding-__MSG_@@bidi_start_edge__: 0;
  padding-__MSG_@@bidi_end_edge__: 1.5em;
  position: relative;
}

बाईं से दाईं ओर लिखी जाने वाली भाषाओं, जैसे कि अंग्रेज़ी के लिए, बोल्ड लाइनें इस तरह दिखती हैं:

  dir: ltr;
  padding-left: 0;
  padding-right: 1.5em;

Locales

आपके पास कई भाषाओं को चुनने का विकल्प होता है. इनमें कुछ ऐसी भाषाएं भी शामिल हैं (जैसे कि en) जिनमें एक ही अनुवाद, किसी भाषा के कई वैरिएंट (जैसे कि en_GB और en_US) के साथ काम करता है.

अपने एक्सटेंशन को Chrome Web Store पर काम करने वाली किसी भी भाषा में स्थानीय भाषा में उपलब्ध कराया जा सकता है. अगर आपकी भाषा यहां मौजूद नहीं है, तो उससे मिलती-जुलती भाषा चुनें. उदाहरण के लिए, अगर आपके एक्सटेंशन की डिफ़ॉल्ट भाषा "de_CH" है, तो Chrome Web Store में "de" चुनें.

भाषा कोड	भाषा (देश/इलाका)
`ar`	अरबी
`am`	अमहैरिक
`bg`	बल्गैरियन
`bn`	बांग्ला
`ca`	कैटलैन
`cs`	चेक
`da`	डैनिश
`de`	जर्मन
`el`	ग्रीक
`en`	अंग्रेज़ी
`en_AU`	अंग्रेज़ी (ऑस्ट्रेलिया)
`en_GB`	अंग्रेज़ी (ग्रेट ब्रिटेन)
`en_US`	अंग्रेज़ी (अमेरिका)
`es`	स्पैनिश
`es_419`	स्पैनिश (लैटिन अमेरिका और कैरेबियन)
`et`	एस्टोनियन
`fa`	फ़ारसी
`fi`	फ़िनिश
`fil`	फ़िलिपीनी
`fr`	फ़्रांसीसी
`gu`	गुजराती
`he`	हीब्रू
`hi`	हिन्दी
`hr`	क्रोएशियन
`hu`	हंगेरियन
`id`	इंडोनेशियन
`it`	इटैलियन
`ja`	जापानी
`kn`	कन्नड़
`ko`	कोरियन
`lt`	लिथुआनियन
`lv`	लातवियन
`ml`	मलयालम
`mr`	मराठी
`ms`	मलय
`nl`	डच
`no`	नॉर्वीजन
`pl`	पोलिश
`pt_BR`	पॉर्चुगीज़ (ब्राज़ील)
`pt_PT`	पॉर्चगीज़ (पुर्तगाल)
`ro`	रोमेनियन
`ru`	रूसी
`sk`	स्लोवाक
`sl`	स्लोवेनियन
`sr`	सर्बियन
`sv`	स्वीडिश
`sw`	स्वाहिली
`ta`	तमिल
`te`	तेलुगु
`th`	थाई
`tr`	टर्किश
`uk`	यूक्रेनियन
`vi`	वियतनामीज़
`zh_CN`	चाइनीज़ (चीन)
`zh_TW`	चाइनीज़ (ताइवान)

संदेश खोजें

यह ज़रूरी नहीं है कि आप हर उस स्थान-भाषा के लिए हर स्ट्रिंग तय करें जो आपके ऐप्लिकेशन में इस्तेमाल की जा सकती है. जब तक डिफ़ॉल्ट स्थान-भाषा की messages.json फ़ाइल में हर स्ट्रिंग के लिए कोई वैल्यू मौजूद है, तब तक आपका एक्सटेंशन या ऐप्लिकेशन काम करता रहेगा. भले ही, अनुवाद कितना भी कम क्यों न हो. एक्सटेंशन सिस्टम, किसी मैसेज को इस तरह खोजता है:

उपयोगकर्ता की पसंदीदा भाषा के लिए, मैसेज फ़ाइल (अगर कोई है) खोजें. उदाहरण के लिए, जब Google Chrome की भाषा ब्रिटिश इंग्लिश (en_GB) पर सेट होती है, तो सिस्टम सबसे पहले /_locales/en_GB/messages.json में मैसेज खोजता है. अगर वह फ़ाइल मौजूद है और उसमें मैसेज है, तो सिस्टम आगे नहीं खोजता.
अगर उपयोगकर्ता की पसंदीदा भाषा में कोई क्षेत्र है (यानी कि भाषा में अंडरस्कोर: _ है), तो उस क्षेत्र के बिना भाषा खोजें. उदाहरण के लिए, अगर en_GB मैसेज फ़ाइल मौजूद नहीं है या उसमें मैसेज नहीं है, तो सिस्टम en मैसेज फ़ाइल में खोजता है. अगर वह फ़ाइल मौजूद है और उसमें मैसेज है, तो सिस्टम आगे नहीं खोजता.
डिफ़ॉल्ट स्थान-भाषा के लिए, मैसेज फ़ाइल खोजें. उदाहरण के लिए, अगर एक्सटेंशन का "default_locale" "es" पर सेट है और /_locales/en_GB/messages.json या /_locales/en/messages.json में से किसी में भी मैसेज नहीं है, तो एक्सटेंशन /_locales/es/messages.json से मैसेज का इस्तेमाल करता है.

नीचे दी गई इमेज में, "colores" नाम का मैसेज उन तीनों भाषाओं में है जो एक्सटेंशन के साथ काम करती हैं. हालांकि, "extName" सिर्फ़ दो भाषाओं में है. अमेरिका में Google Chrome का इस्तेमाल करने वाले किसी व्यक्ति को "Colors" लेबल दिखता है, जबकि ब्रिटिश अंग्रेज़ी का इस्तेमाल करने वाले व्यक्ति को "Colours" दिखता है. अमेरिकन इंग्लिश और ब्रिटिश इंग्लिश, दोनों भाषाओं के उपयोगकर्ताओं को एक्सटेंशन का नाम "Hello World" दिखता है. डिफ़ॉल्ट भाषा स्पेनिश होने की वजह से, Google Chrome को अंग्रेज़ी के अलावा किसी अन्य भाषा में इस्तेमाल करने वाले उपयोगकर्ताओं को "Colores" लेबल और "Hola mundo" एक्सटेंशन का नाम दिखता है.

चार फ़ाइलें: manifest.json और तीन messages.json फ़ाइलें (es, en, और en_GB के लिए). es और en फ़ाइलों में, 'extName' और 'colores' नाम के मैसेज की एंट्री दिखती हैं. en_GB फ़ाइल में सिर्फ़ एक एंट्री ('colores' के लिए) होती है.

अपने ब्राउज़र की भाषा सेट करना

अनुवादों की जांच करने के लिए, आपको अपने ब्राउज़र की स्थान-भाषा सेट करनी पड़ सकती है. इस सेक्शन में, Windows, macOS, Linux, और ChromeOS में स्थानीय भाषा सेट करने का तरीका बताया गया है.

Windows

भाषा के हिसाब से बने शॉर्टकट या Google Chrome के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, भाषा को बदला जा सकता है. इसे सेट अप करने के बाद, शॉर्टकट का तरीका ज़्यादा तेज़ होता है. इससे आपको एक साथ कई भाषाओं का इस्तेमाल करने की सुविधा मिलती है.

किसी खास भाषा के लिए बने शॉर्टकट का इस्तेमाल करना

किसी खास भाषा में Google Chrome को लॉन्च करने वाला शॉर्टकट बनाने और उसका इस्तेमाल करने के लिए:

अपने डेस्कटॉप पर पहले से मौजूद Google Chrome के शॉर्टकट की कॉपी बनाएं.
नए शॉर्टकट का नाम बदलकर, नई भाषा के हिसाब से रखें.
शॉर्टकट की प्रॉपर्टी बदलें, ताकि टारगेट फ़ील्ड में --lang और --user-data-dir फ़्लैग की जानकारी दी जा सके. टारगेट कुछ ऐसा दिखना चाहिए:
```
path_to_chrome.exe --lang=locale --user-data-dir=c:\locale_profile_dir
```
शॉर्टकट पर दो बार क्लिक करके, Google Chrome लॉन्च करें.

उदाहरण के लिए, Google Chrome को स्पैनिश (es) में लॉन्च करने वाला शॉर्टकट बनाने के लिए, chrome-es नाम का शॉर्टकट बनाया जा सकता है. इसमें यह टारगेट शामिल होगा:

path_to_chrome.exe --lang=es --user-data-dir=c:\chrome-profile-es

जितने चाहें उतने शॉर्टकट बनाए जा सकते हैं. इससे अलग-अलग भाषाओं में टेस्ट करना आसान हो जाता है. उदाहरण के लिए:

path_to_chrome.exe --lang=en --user-data-dir=c:\chrome-profile-en
path_to_chrome.exe --lang=en_GB --user-data-dir=c:\chrome-profile-en_GB
path_to_chrome.exe --lang=ko --user-data-dir=c:\chrome-profile-ko

ध्यान दें: --user-data-dir की वैल्यू देना ज़रूरी नहीं है, लेकिन इससे मदद मिलती है. हर स्थान-भाषा के लिए एक डेटा डायरेक्ट्री होने से, ब्राउज़र को एक ही समय पर कई भाषाओं में चलाया जा सकता है. इसका एक नुकसान यह है कि स्थानीय भाषा का डेटा शेयर नहीं किया जाता. इसलिए, आपको अपना एक्सटेंशन कई बार इंस्टॉल करना होगा—हर स्थानीय भाषा के लिए एक बार. अगर आपको वह भाषा नहीं आती, तो यह आपके लिए मुश्किल हो सकता है. ज़्यादा जानकारी के लिए, प्रोफ़ाइलें बनाना और उनका इस्तेमाल करना लेख पढ़ें.

यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करना

Windows के लिए Google Chrome पर यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, स्थान-भाषा बदलने का तरीका यहां बताया गया है:

ऐप्लिकेशन का आइकॉन > विकल्प
अंडर द हुड टैब चुनें
स्क्रोल करके वेब कॉन्टेंट पर जाएं
फ़ॉन्ट और भाषा की सेटिंग बदलें पर क्लिक करें
भाषाएं टैब को चुनें
Google Chrome की भाषा सेट करने के लिए, ड्रॉप-डाउन का इस्तेमाल करें
Chrome को रीस्टार्ट करें

Mac OS

Mac पर स्थान-भाषा बदलने के लिए, सिस्टम की सेटिंग का इस्तेमाल किया जाता है.

Apple मेन्यू में जाकर, सिस्टम की सेटिंग को चुनें
Personal सेक्शन में जाकर, International को चुनें
अपनी भाषा और जगह की जानकारी चुनना
Chrome को रीस्टार्ट करें

Linux

Linux पर स्थानीय भाषा बदलने के लिए, पहले Google Chrome को बंद करें. इसके बाद, एक ही लाइन में LANGUAGE एनवायरमेंट वैरिएबल सेट करें और Google Chrome लॉन्च करें. उदाहरण के लिए:

LANGUAGE=es ./chrome

ChromeOS

ChromeOS पर स्थान-भाषा बदलने के लिए:

सिस्टम ट्रे में जाकर, सेटिंग को चुनें.
भाषाएं और इनपुट सेक्शन में जाकर, भाषा ड्रॉप-डाउन चुनें.
अगर आपकी भाषा सूची में मौजूद नहीं है, तो भाषाएं जोड़ें पर क्लिक करके उसे जोड़ें.
भाषा जोड़ने के बाद, उसके बगल में मौजूद तीन बिंदु वाले ज़्यादा कार्रवाइयां मेन्यू आइटम पर क्लिक करें. इसके बाद, ChromeOS को इस भाषा में दिखाएं को चुनें.
ChromeOS को रीस्टार्ट करने के लिए, सेट की गई भाषा के बगल में मौजूद, रीस्टार्ट करें बटन पर क्लिक करें.

उदाहरण

इंटरनैशनलाइज़ेशन के उदाहरण, examples/api/i18n डायरेक्ट्री में देखे जा सकते हैं. पूरा उदाहरण देखने के लिए, examples/extensions/news पर जाएं. अन्य उदाहरणों और सोर्स कोड को देखने में मदद पाने के लिए, सैंपल देखें.

getMessage()

नीचे दिया गया कोड, ब्राउज़र से स्थानीय भाषा में मैसेज लेता है और उसे स्ट्रिंग के तौर पर दिखाता है. यह मैसेज में मौजूद दो प्लेसहोल्डर को "string1" और "string2" स्ट्रिंग से बदल देता है.

function getMessage() {
  var message = chrome.i18n.getMessage("click_here", ["string1", "string2"]);
  document.getElementById("languageSpan").innerHTML = message;
}

यहां एक स्ट्रिंग देने और उसका इस्तेमाल करने का तरीका बताया गया है:

  // In JavaScript code
  status.innerText = chrome.i18n.getMessage("error", errorDetails);

"error": {
  "message": "Error: $details$",
  "description": "Generic error template. Expects error parameter to be passed in.",
  "placeholders": {
    "details": {
      "content": "$1",
      "example": "Failed to fetch RSS feed."
    }
  }
}

प्लेसहोल्डर के बारे में ज़्यादा जानकारी के लिए, लोकेल के हिसाब से मैसेज पेज देखें. getMessage() को कॉल करने के बारे में ज़्यादा जानकारी के लिए, एपीआई का संदर्भ देखें.

getAcceptLanguages()

इस कोड से, ब्राउज़र से स्वीकार की जाने वाली भाषाएं मिलती हैं. साथ ही, हर भाषा को ',' से अलग करके, स्ट्रिंग के तौर पर दिखाया जाता है.

function getAcceptLanguages() {
  chrome.i18n.getAcceptLanguages(function(languageList) {
    var languages = languageList.join(",");
    document.getElementById("languageSpan").innerHTML = languages;
  })
}

getAcceptLanguages() को कॉल करने के बारे में ज़्यादा जानने के लिए, एपीआई का संदर्भ देखें.

detectLanguage()

नीचे दिया गया कोड, दी गई स्ट्रिंग से ज़्यादा से ज़्यादा तीन भाषाओं का पता लगाता है. साथ ही, नतीजे को नई लाइनों से अलग की गई स्ट्रिंग के तौर पर दिखाता है.

function detectLanguage(inputText) {
  chrome.i18n.detectLanguage(inputText, function(result) {
    var outputLang = "Detected Language: ";
    var outputPercent = "Language Percentage: ";
    for(i = 0; i < result.languages.length; i++) {
      outputLang += result.languages[i].language + " ";
      outputPercent +=result.languages[i].percentage + " ";
    }
    document.getElementById("languageSpan").innerHTML = outputLang + "\n" + outputPercent + "\nReliable: " + result.isReliable;
  });
}

detectLanguage(inputText) को कॉल करने के बारे में ज़्यादा जानकारी के लिए, एपीआई का संदर्भ देखें.

टाइप

LanguageCode

Chrome 47+ browser.* Chrome 148 से

ISO भाषा कोड, जैसे कि en या fr. इस तरीके के साथ काम करने वाली भाषाओं की पूरी सूची देखने के लिए, kLanguageInfoTable देखें. किसी अनजान भाषा के लिए, und दिखाया जाएगा. इसका मतलब है कि टेक्स्ट का [percentage] हिस्सा, सीएलडी के लिए अनजान है

टाइप

स्ट्रिंग

तरीके

detectLanguage()

Chrome 47+ browser.* Chrome 148 से

browser.i18n.detectLanguage(
  text: string,
): Promise<object>

सीएलडी का इस्तेमाल करके, दिए गए टेक्स्ट की भाषा का पता लगाता है.

पैरामीटर

टेक्स्ट

स्ट्रिंग

उपयोगकर्ता की ओर से डाली गई स्ट्रिंग, जिसका अनुवाद किया जाना है.

रिटर्न

Promise<object>

Chrome 99+ browser.* Chrome 148 से

getAcceptLanguages()

browser.i18n.getAcceptLanguages(): Promise<LanguageCode[]>

यह ब्राउज़र में सेट की गई उपयोगकर्ता की पसंदीदा भाषाएं फ़ेच करता है. यह ब्राउज़र की ओर से इस्तेमाल की जाने वाली स्थान-भाषा से अलग है. स्थान-भाषा पाने के लिए, i18n.getUILanguage का इस्तेमाल करें.

रिटर्न

Promise<LanguageCode[]>

Chrome 99+ browser.* Chrome 148 से

getMessage()

browser.i18n.getMessage(
  messageName: string,
  substitutions?: any,
  options?: object,
): string

इससे, तय किए गए मैसेज के लिए स्थानीय भाषा में स्ट्रिंग मिलती है. अगर मैसेज मौजूद नहीं है, तो यह तरीका एक खाली स्ट्रिंग ('') दिखाता है. अगर getMessage() कॉल का फ़ॉर्मैट गलत है — उदाहरण के लिए, messageName कोई स्ट्रिंग नहीं है या substitutions कलेक्शन में नौ से ज़्यादा एलिमेंट हैं — तो यह तरीका undefined दिखाता है.

पैरामीटर

messageName

स्ट्रिंग

मैसेज का नाम, जैसा कि messages.json फ़ाइल में बताया गया है.
सब्सिटिट्यूशन

ज़रूरी नहीं

अगर मैसेज में ज़रूरत हो, तो ज़्यादा से ज़्यादा नौ सब्स्टिट्यूशन स्ट्रिंग.
विकल्प

object ज़रूरी नहीं

Chrome 79+ browser.* Chrome 148 से
- escapeLt
  
  बूलियन ज़रूरी नहीं
  
  < को अनुवाद में < से एस्केप करें. यह सिर्फ़ मैसेज पर लागू होता है, प्लेसहोल्डर पर नहीं. अगर अनुवाद का इस्तेमाल एचटीएमएल कॉन्टेक्स्ट में किया जाता है, तो डेवलपर इसका इस्तेमाल कर सकते हैं. Closure Compiler के साथ इस्तेमाल किए जाने वाले Closure Templates, इसे अपने-आप जनरेट करते हैं.

रिटर्न

स्ट्रिंग

मौजूदा स्थान-भाषा के लिए स्थानीय भाषा में मैसेज.

getUILanguage()

browser.i18n.getUILanguage(): string

ब्राउज़र के यूज़र इंटरफ़ेस (यूआई) की भाषा की जानकारी मिलती है. यह i18n.getAcceptLanguages से अलग है, जो उपयोगकर्ता की पसंदीदा भाषाएं दिखाता है.

रिटर्न

स्ट्रिंग

ब्राउज़र के यूज़र इंटरफ़ेस (यूआई) की भाषा का कोड, जैसे कि en-US या fr-FR.

browser.i18n संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

ब्यौरा

मेनिफ़ेस्ट

कॉन्सेप्ट और इस्तेमाल

कई भाषाओं में उपलब्ध है

पहले से तय मैसेज

Locales

संदेश खोजें

अपने ब्राउज़र की भाषा सेट करना

Windows

किसी खास भाषा के लिए बने शॉर्टकट का इस्तेमाल करना

यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करना

Mac OS

Linux

ChromeOS

उदाहरण

getMessage()

getAcceptLanguages()

detectLanguage()

टाइप

LanguageCode

टाइप

तरीके

detectLanguage()

पैरामीटर

रिटर्न

getAcceptLanguages()

रिटर्न

getMessage()

पैरामीटर

रिटर्न

getUILanguage()

रिटर्न

browser.i18n