remoting/webapp/js_proto/dom_proto.js

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 // This file contains various hacks needed to inform JSCompiler of various
   6 // WebKit- and Chrome-specific properties and methods. It is used only with
   7 // JSCompiler to verify the type-correctness of our code.
   8
   9 /** @type {Array<string>} */
  10 ClipboardData.prototype.types;
  11
  12 /** @type {HTMLElement} */
  13 Document.prototype.activeElement;
  14
  15 /** @type {Array<HTMLElement>} */
  16 Document.prototype.all;
  17
  18 /** @type {boolean} */
  19 Document.prototype.hidden;
  20
  21 /** @return {void} Nothing. */
  22 Document.prototype.exitPointerLock = function() {};
  23
  24 /** @type {boolean} */
  25 Document.prototype.webkitIsFullScreen;
  26
  27 /** @type {boolean} */
  28 Document.prototype.webkitHidden;
  29
  30 /** @type {Element} */
  31 Document.prototype.firstElementChild;
  32
  33 /** @return {void} Nothing. */
  34 Element.prototype.requestPointerLock = function() {};
  35
  36 /** @type {boolean} */
  37 Element.prototype.disabled;
  38
  39 /** @type {boolean} */
  40 Element.prototype.hidden;
  41
  42 /** @type {string} */
  43 Element.prototype.innerText;
  44
  45 /** @type {string} */
  46 Element.prototype.localName;
  47
  48 /** @type {number} */
  49 Element.prototype.offsetRight;
  50
  51 /** @type {number} */
  52 Element.prototype.offsetBottom;
  53
  54 /** @type {string} */
  55 Element.prototype.textContent;
  56
  57 /** @type {DOMTokenList} */
  58 Element.prototype.classList;
  59
  60 /** @type {boolean} */
  61 Element.prototype.checked;
  62
  63 /** @type {Window} */
  64 HTMLIFrameElement.prototype.contentWindow;
  65
  66 /**
  67  * @param {string} selector
  68  * @return {?HTMLElement}.
  69  */
  70 HTMLElement.prototype.querySelector = function(selector) {};
  71
  72 /**
  73  * @param {string} name
  74  * @return {string}
  75  */
  76 Node.prototype.getAttribute = function(name) { };
  77
  78 /** @type {string} */
  79 Node.prototype.value;
  80
  81 /** @type {{top: string, left: string, bottom: string, right: string}} */
  82 Node.prototype.style;
  83
  84 /** @type {boolean} */
  85 Node.prototype.hidden;
  86
  87
  88 /** @type {{getRandomValues: function(!ArrayBufferView):!ArrayBufferView}} */
  89 Window.prototype.crypto;
  90
  91
  92 /**
  93  * @type {DataTransfer}
  94  */
  95 Event.prototype.dataTransfer = null;
  96
  97 /**
  98  * @type {number}
  99  */
 100 Event.prototype.movementX = 0;
 101
 102 /**
 103  * @type {number}
 104  */
 105 Event.prototype.movementY = 0;
 106
 107 /**
 108  * @param {string} type
 109  * @param {boolean} canBubble
 110  * @param {boolean} cancelable
 111  * @param {Window} view
 112  * @param {number} detail
 113  * @param {number} screenX
 114  * @param {number} screenY
 115  * @param {number} clientX
 116  * @param {number} clientY
 117  * @param {boolean} ctrlKey
 118  * @param {boolean} altKey
 119  * @param {boolean} shiftKey
 120  * @param {boolean} metaKey
 121  * @param {number} button
 122  * @param {EventTarget} relatedTarget
 123  */
 124 Event.prototype.initMouseEvent = function(
 125     type, canBubble, cancelable, view, detail,
 126     screenX, screenY, clientX, clientY,
 127     ctrlKey, altKey, shiftKey, metaKey,
 128     button, relatedTarget) {};
 129
 130 /** @type {Object} */
 131 Event.prototype.data = {};
 132
 133 // Chrome implements XMLHttpRequest.responseURL starting from Chrome 37.
 134 /** @type {string} */
 135 XMLHttpRequest.prototype.responseURL = "";
 136
 137
 138 /*******************************************************************************
 139  * Webview and related declarations
 140  ******************************************************************************/
 141
 142 /**
 143  * Like chrome.webRequest, but for webview tags.
 144  *
 145  * chrome.webRequest defined in chrome_extensions.js can't be
 146  * used because it's not a type.
 147  *
 148  * @constructor
 149  */
 150 function WebviewWebRequest() {}
 151
 152 /** @type {WebRequestEvent} */
 153 WebviewWebRequest.prototype.onBeforeSendHeaders;
 154
 155 /** @type {WebRequestEvent} */
 156 WebviewWebRequest.prototype.onCompleted;
 157
 158 /** @type {WebRequestOnErrorOccurredEvent} */
 159 WebviewWebRequest.prototype.onErrorOccurred;
 160
 161 /**
 162  * Enable access to special APIs of webview DOM element.
 163  *
 164  * @constructor
 165  * @extends {HTMLElement}
 166  */
 167 function Webview() {}
 168
 169 /** @type {!WebviewWebRequest} */
 170 Webview.prototype.request;
 171
 172 /** @type {function(InjectDetails, function(Object))} */
 173 Webview.prototype.executeScript;
 174
 175 /** @type {Window} */
 176 Webview.prototype.contentWindow;
 177
 178 /**
 179  * See https://developer.chrome.com/apps/tags/webview#type-InjectDetails
 180  *
 181  * @typedef {{
 182  *   file: (string|undefined),
 183  *   code: (string|undefined)
 184  * }}
 185  */
 186 var InjectDetails;
 187
 188 /*******************************************************************************
 189  * ConsoleMessage event
 190  ******************************************************************************/
 191
 192 /**
 193  * The consolemessage BrowserEvent contains these fields:
 194  * e.level: int32, log severity level (for exception/info etc)
 195  * e.line: int32, line number
 196  * e.message: string, the console message
 197  * e.sourceId: string, source identifier (the ones seen in devtools)
 198  *
 199  * @constructor
 200  * @extends {Event}
 201  */
 202 chrome.ConsoleMessageBrowserEvent = function() {};
 203
 204 /** @type {number} */
 205 chrome.ConsoleMessageBrowserEvent.prototype.level;
 206
 207 /** @type {number} */
 208 chrome.ConsoleMessageBrowserEvent.prototype.line;
 209
 210 /** @type {string} */
 211 chrome.ConsoleMessageBrowserEvent.prototype.message;
 212
 213 /** @type {string} */
 214 chrome.ConsoleMessageBrowserEvent.prototype.sourceId;