From ec11b6d474b571f04617b098cd9484b56d4c9e40 Mon Sep 17 00:00:00 2001
From: uzlopak <aras.abbasi@googlemail.com>
Date: Sun, 29 Oct 2023 13:53:40 +0100
Subject: [PATCH] lib: add navigator.language & navigator.languages

---
 doc/api/globals.md              | 34 +++++++++++++++++++++++++++++++++
 lib/internal/navigator.js       | 23 ++++++++++++++++++++++
 test/parallel/test-navigator.js | 18 +++++++++++++++++
 3 files changed, 75 insertions(+)

diff --git a/doc/api/globals.md b/doc/api/globals.md
index ebaaf2a6e0012e..fe7a998708c72c 100644
--- a/doc/api/globals.md
+++ b/doc/api/globals.md
@@ -637,6 +637,40 @@ logical processors available to the current Node.js instance.
 console.log(`This process is running on ${navigator.hardwareConcurrency} logical processors`);
 ```
 
+### `navigator.language`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+* {string}
+
+The `navigator.language` read-only property returns a string representing the
+preferred language of the Node.js instance.
+
+The value is representing the language version as defined in RFC <5646>.
+The default value is `'en-US'`.
+
+```js
+console.log(`The preferred language of the Node.js instance has the tag '${navigator.language}'`);
+```
+
+### `navigator.languages`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+* {Array<string>}
+
+The `navigator.languages` read-only property returns an array of strings
+representing the preferred languages of the Node.js instance.
+The default value is `['en-US']`.
+
+```js
+console.log(`The preferred languages are '${navigator.language}'`);
+```
+
 ### `navigator.userAgent`
 
 <!-- YAML
diff --git a/lib/internal/navigator.js b/lib/internal/navigator.js
index bfd2813414b26d..6069f57dc375d6 100644
--- a/lib/internal/navigator.js
+++ b/lib/internal/navigator.js
@@ -2,9 +2,14 @@
 
 const {
   ObjectDefineProperties,
+  ObjectFreeze,
   Symbol,
 } = primordials;
 
+const {
+  Intl,
+} = globalThis;
+
 const {
   ERR_ILLEGAL_CONSTRUCTOR,
 } = require('internal/errors').codes;
@@ -24,6 +29,8 @@ class Navigator {
   // Private properties are used to avoid brand validations.
   #availableParallelism;
   #userAgent = `Node.js/${nodeVersion.slice(1, nodeVersion.indexOf('.'))}`;
+  #language = Intl?.Collator().resolvedOptions().locale || 'en-US';
+  #languages = ObjectFreeze([this.#language]);
 
   constructor() {
     if (arguments[0] === kInitialize) {
@@ -40,6 +47,20 @@ class Navigator {
     return this.#availableParallelism;
   }
 
+  /**
+   * @return {string}
+   */
+  get language() {
+    return this.#language;
+  }
+
+  /**
+   * @return {Array<string>}
+   */
+  get languages() {
+    return this.#languages;
+  }
+
   /**
    * @return {string}
    */
@@ -50,6 +71,8 @@ class Navigator {
 
 ObjectDefineProperties(Navigator.prototype, {
   hardwareConcurrency: kEnumerableProperty,
+  language: kEnumerableProperty,
+  languages: kEnumerableProperty,
   userAgent: kEnumerableProperty,
 });
 
diff --git a/test/parallel/test-navigator.js b/test/parallel/test-navigator.js
index 24839301478a74..ad6dfd66e63637 100644
--- a/test/parallel/test-navigator.js
+++ b/test/parallel/test-navigator.js
@@ -15,3 +15,21 @@ is.number(navigator.hardwareConcurrency, 'hardwareConcurrency');
 assert.ok(navigator.hardwareConcurrency > 0);
 assert.strictEqual(typeof navigator.userAgent, 'string');
 assert.match(navigator.userAgent, /^Node\.js\/\d+$/);
+
+assert.strictEqual(typeof navigator.language, 'string');
+assert.strictEqual(navigator.language, 'en-US');
+
+assert.ok(Array.isArray(navigator.languages));
+assert.strictEqual(navigator.languages.length, 1);
+assert.strictEqual(typeof navigator.languages[0], 'string');
+
+assert.throws(() => {
+  navigator.languages[0] = 'foo';
+}, new TypeError("Cannot assign to read only property '0' of object '[object Array]'"));
+assert.notStrictEqual(navigator.languages[0], 'foo');
+assert.strictEqual(navigator.languages[0], 'en-US');
+
+Object.defineProperty(navigator, 'language', { value: 'de-DE' });
+assert.strictEqual(navigator.language, 'de-DE');
+assert.strictEqual(navigator.languages.length, 1);
+assert.strictEqual(navigator.languages[0], 'en-US');