diff --git a/docs/api/browser-window.md b/docs/api/browser-window.md
index fa3fd5236224..14a51bdb3ca3 100644
--- a/docs/api/browser-window.md
+++ b/docs/api/browser-window.md
@@ -826,8 +826,10 @@ On Linux always returns `true`.
 #### `win.setAlwaysOnTop(flag[, level])`
 
 * `flag` Boolean
-* `level` String (optional) _macOS_ - Options include (`normal`, `floating`, `torn-off-menu`,
-`modal-panel`, `main-menu`, `status`, `pop-up-menu`, `screen-saver`, `dock`). Default is `floating`.
+* `level` String (optional) _macOS_ - Values include `normal`, `floating`,
+  `torn-off-menu`, `modal-panel`, `main-menu`, `status`, `pop-up-menu`,
+  `screen-saver`, and `dock`. The default is `floating`. See the
+  [macOS docs][window-levels] for more details.
 
 Sets whether the window should show always on top of other windows. After
 setting this, the window is still a normal window, not a toolbox window which
@@ -1201,3 +1203,5 @@ Returns `BrowserWindow` - The parent window.
 #### `win.getChildWindows()`
 
 Returns `BrowserWindow[]` - All child windows.
+
+[window-levels]: https://developer.apple.com/reference/appkit/nswindow/1664726-window_levels
diff --git a/spec/api-browser-window-spec.js b/spec/api-browser-window-spec.js
index 23c426aa9eb1..a0b043ed22f5 100644
--- a/spec/api-browser-window-spec.js
+++ b/spec/api-browser-window-spec.js
@@ -408,6 +408,18 @@ describe('browser-window module', function () {
     })
   })
 
+  describe('BrowserWindow.setAlwaysOnTop(flag, level)', function () {
+    it('sets the window as always on top', function () {
+      assert.equal(w.isAlwaysOnTop(), false)
+      w.setAlwaysOnTop(true, 'dock')
+      assert.equal(w.isAlwaysOnTop(), true)
+      w.setAlwaysOnTop(false)
+      assert.equal(w.isAlwaysOnTop(), false)
+      w.setAlwaysOnTop(true)
+      assert.equal(w.isAlwaysOnTop(), true)
+    })
+  })
+
   describe('BrowserWindow.fromId(id)', function () {
     it('returns the window with id', function () {
       assert.equal(w.id, BrowserWindow.fromId(w.id).id)