Correct the function of Window.get inconformity with the original design

xzhan96 · rogerwang · commit 963f13263f3c · 2017-03-22T13:36:42.000+08:00
iframe's window should not have independent Window object fixed nwjs#5043, nwjs#5044, nwjs#5755
diff --git a/docs/References/Window.md b/docs/References/Window.md
@@ -3,10 +3,13 @@
 
 [TOC]
 
-`Window` is a wrapper of the DOM's `window` object. It has extended operations and can receive various window events.
+`Window` is a wrapper of the DOM's topmost `window` object. It has extended operations and can receive various window events.
 
 Every `Window` is an instance of the EventEmitter class, and you're able to use `Window.on(...)` to respond to native window's events.
 
+!!! warning "Behavior Changed"
+    There are some changes of `Window` since 0.13.0. Please see [Migration Notes from 0.12 to 0.13](../For Users/Migration/From 0.12 to 0.13.md).
+
 ## Synopsis
 
 ```javascript
@@ -41,10 +44,19 @@ nw.Window.open('https://github.com', {}, function(new_win) {
 
 If `window_object` is not specifed, then return current window's `Window` object, otherwise return `window_object`'s `Window` object.
 
+!!! note
+    If `window_object` is `iframe`'s, the function will still return topmost window's `Window` object.
+
 ```javascript
 // Get the current window
 var win = nw.Window.get();
 
+// Get iframe's window
+var iframeWin = nw.Window.get(iframe.contentWindow);
+
+//This will return true
+console.log(iframeWin === win);
+
 // Create a new window and get it
 nw.Window.open('https://github.com/nwjs/nw.js', {}, function(new_win) {
   // do something with the newly created window
diff --git a/src/resources/api_nw_window.js b/src/resources/api_nw_window.js
@@ -170,7 +170,7 @@ nw_binding.registerCustomHook(function(bindingsAPI) {
   var apiFunctions = bindingsAPI.apiFunctions;
   apiFunctions.setHandleRequest('get', function(domWindow) {
     if (domWindow)
-      return try_nw(domWindow).nw.Window.get();
+      return try_nw(domWindow.top).nw.Window.get();
     if (currentNWWindow)
       return currentNWWindow.outerWindow;
 
