From b013d4b55c63b4473867f5026ec86d74a17ebb94 Mon Sep 17 00:00:00 2001
From: Yagiz Nizipli <yagiz@nizipli.com>
Date: Mon, 16 Oct 2023 13:03:44 -0400
Subject: [PATCH] lib: add `navigator.userAgent`

---
 doc/api/globals.md              | 15 +++++++++++++++
 lib/internal/navigator.js       | 10 ++++++++++
 test/parallel/test-navigator.js |  2 ++
 3 files changed, 27 insertions(+)

diff --git a/doc/api/globals.md b/doc/api/globals.md
index 01a6d9327a1669..4efa04e8c1b883 100644
--- 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
index 5971891ea73cc9..bfd2813414b26d 100644
--- 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
index 300446f2c5dcdc..24839301478a74 100644
--- 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+$/);