lib: add navigator.userAgent

PR-URL: #50200 Reviewed-By: Geoffrey Booth <[email protected]> Reviewed-By: Matthew Aitken <[email protected]> Reviewed-By: Matteo Collina <[email protected]> Reviewed-By: Vinícius Lourenço Claro Cardoso <[email protected]>
nodejs · Oct 23, 2023 · 5a52c51 · 5a52c51
1 parent a362c27
commit 5a52c51
Show file tree

Hide file tree

Showing 3 changed files with 27 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 major version number.
+
+```js
+console.log(`The user-agent is ${navigator.userAgent}`); // Prints "Node.js/21"
+```
+
 ## `PerformanceEntry`
 
 <!-- YAML

diff --git a/lib/internal/navigator.js b/lib/internal/navigator.js
@@ -18,10 +18,12 @@ const {
 } = internalBinding('os');
 
 const kInitialize = Symbol('kInitialize');
+const nodeVersion = process.version;
 
 class Navigator {
   // Private properties are used to avoid brand validations.
   #availableParallelism;
+  #userAgent = `Node.js/${nodeVersion.slice(1, nodeVersion.indexOf('.'))}`;
 
   constructor() {
     if (arguments[0] === kInitialize) {
@@ -37,10 +39,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,5 @@ const is = {
 is.number(+navigator.hardwareConcurrency, 'hardwareConcurrency');
 is.number(navigator.hardwareConcurrency, 'hardwareConcurrency');
 assert.ok(navigator.hardwareConcurrency > 0);
+assert.strictEqual(typeof navigator.userAgent, 'string');
+assert.match(navigator.userAgent, /^Node\.js\/\d+$/);