From 6e746f1a55e5d94f1a8330d3436a64ed8d6f639b Mon Sep 17 00:00:00 2001
From: Bartosz Sosnowski <bartosz@janeasystems.com>
Date: Wed, 12 Sep 2018 11:07:00 +0200
Subject: [PATCH] doc, win: improve os.setPriority documentation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

PR-URL: https://github.com/nodejs/node/pull/22817
Fixes: https://github.com/nodejs/node/issues/22799
Reviewed-By: Tobias Nießen <tniessen@tnie.de>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
---
 doc/api/os.md                             | 3 +++
 test/parallel/test-os-process-priority.js | 4 +++-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/doc/api/os.md b/doc/api/os.md
index a0ff5e7ff17..ad5736d7690 100644
--- a/doc/api/os.md
+++ b/doc/api/os.md
@@ -371,6 +371,9 @@ priority classes, `priority` is mapped to one of six priority constants in
 mapping may cause the return value to be slightly different on Windows. To avoid
 confusion, it is recommended to set `priority` to one of the priority constants.
 
+On Windows setting priority to `PRIORITY_HIGHEST` requires elevated user,
+otherwise the set priority will be silently reduced to `PRIORITY_HIGH`.
+
 ## os.tmpdir()
 <!-- YAML
 added: v0.9.9
diff --git a/test/parallel/test-os-process-priority.js b/test/parallel/test-os-process-priority.js
index 9d66cfc49bc..05686e6c770 100644
--- a/test/parallel/test-os-process-priority.js
+++ b/test/parallel/test-os-process-priority.js
@@ -116,8 +116,10 @@ function checkPriority(pid, expected) {
     return;
   }
 
+  // On Windows setting PRIORITY_HIGHEST will only work for elevated user,
+  // for others it will be silently reduced to PRIORITY_HIGH
   if (expected < PRIORITY_HIGH)
-    assert.strictEqual(priority, PRIORITY_HIGHEST);
+    assert.ok(priority === PRIORITY_HIGHEST || priority === PRIORITY_HIGH);
   else if (expected < PRIORITY_ABOVE_NORMAL)
     assert.strictEqual(priority, PRIORITY_HIGH);
   else if (expected < PRIORITY_NORMAL)