lib: add navigator.userAgent

nodejs · Oct 16, 2023 · 1704a23 · 1704a23
1 parent f0e720a
commit 1704a23
Show file tree

Hide file tree

Showing 3 changed files with 25 additions and 0 deletions.
diff --git a/doc/api/globals.md b/doc/api/globals.md
@@ -629,6 +629,21 @@ logical processors available to the current Node.js instance.
 console.log(`This process is running on ${navigator.hardwareConcurrency}`);
 ```
 
+### `navigator.userAgent`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+* {string}
+
+The `navigator.userAgent` read-only property returns user agent
+consisting of the runtime name and the version.
+
+```js
+console.log(`The user-agent is ${navigator.userAgent}`);
+```
+
 ## `PerformanceEntry`
 
 <!-- YAML

diff --git a/lib/internal/navigator.js b/lib/internal/navigator.js
@@ -22,6 +22,7 @@ const kInitialize = Symbol('kInitialize');
 class Navigator {
   // Private properties are used to avoid brand validations.
   #availableParallelism;
+  #userAgent = `Node.js/${process.version}`;
 
   constructor() {
     if (arguments[0] === kInitialize) {
@@ -37,10 +38,18 @@ class Navigator {
     this.#availableParallelism ??= getAvailableParallelism();
     return this.#availableParallelism;
   }
+
+  /**
+   * @return {string}
+   */
+  get userAgent() {
+    return this.#userAgent;
+  }
 }
 
 ObjectDefineProperties(Navigator.prototype, {
   hardwareConcurrency: kEnumerableProperty,
+  userAgent: kEnumerableProperty,
 });
 
 module.exports = {

diff --git a/test/parallel/test-navigator.js b/test/parallel/test-navigator.js
@@ -13,3 +13,4 @@ const is = {
 is.number(+navigator.hardwareConcurrency, 'hardwareConcurrency');
 is.number(navigator.hardwareConcurrency, 'hardwareConcurrency');
 assert.ok(navigator.hardwareConcurrency > 0);
+assert.strictEqual(typeof navigator.userAgent, 'string');