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 फ़ाइल में हर स्ट्रिंग के लिए कोई वैल्यू मौजूद है, तब तक आपका एक्सटेंशन या ऐप्लिकेशन काम करेगा. भले ही, अनुवाद कितना भी कम क्यों न हो. एक्सटेंशन सिस्टम, किसी मैसेज को इस तरह खोजता है:

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

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

    path_to_chrome.exe --lang=locale --user-data-dir=c:\locale_profile_dir
    
  4. शॉर्टकट पर दो बार क्लिक करके, 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
यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करना

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

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

macOS

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

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

Linux

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

LANGUAGE=es ./chrome

ChromeOS

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

  1. सिस्टम ट्रे में जाकर, सेटिंग को चुनें.
  2. भाषाएं और इनपुट सेक्शन में जाकर, भाषा ड्रॉप-डाउन चुनें.
  3. अगर आपकी भाषा सूची में नहीं है, तो भाषाएं जोड़ें पर क्लिक करके उसे जोड़ें.
  4. भाषा जोड़ने के बाद, अपनी भाषा के बगल में मौजूद, तीन बिंदु वाले ज़्यादा कार्रवाइयां मेन्यू आइटम पर क्लिक करें. इसके बाद, ChromeOS को इस भाषा में दिखाएं को चुनें.
  5. 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

      बूलियन ज़रूरी नहीं

      < का अनुवाद &lt; में करें. यह सिर्फ़ मैसेज पर लागू होता है, प्लेसहोल्डर पर नहीं. अगर अनुवाद का इस्तेमाल एचटीएमएल कॉन्टेक्स्ट में किया जाता है, तो डेवलपर इसका इस्तेमाल कर सकते हैं. Closure Compiler के साथ इस्तेमाल किए जाने वाले Closure Templates, इसे अपने-आप जनरेट करते हैं.

रिटर्न

  • स्ट्रिंग

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

getUILanguage()

browser.i18n.getUILanguage(): string

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

रिटर्न

  • स्ट्रिंग

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