/* * Copyright (C) 2006, 2007, 2008, 2009, 2013 Apple Inc. All rights reserved. * Copyright (C) 2011 Google Inc. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ [ ImplicitThis, CheckSecurity, JSCustomDefineOwnProperty, CustomDeleteProperty, CustomGetOwnPropertySlot, CustomEnumerateProperty, CustomProxyToJSObject, JSCustomMarkFunction, JSCustomToNativeObject, CustomPutFunction, JSLegacyParent=JSDOMWindowBase, InterfaceName=Window, ] interface DOMWindow : EventTarget { // DOM Level 0 [Replaceable] readonly attribute Screen screen; readonly attribute History history; [Replaceable] readonly attribute BarProp locationbar; [Replaceable] readonly attribute BarProp menubar; [Replaceable] readonly attribute BarProp personalbar; [Replaceable] readonly attribute BarProp scrollbars; [Replaceable] readonly attribute BarProp statusbar; [Replaceable] readonly attribute BarProp toolbar; readonly attribute Navigator navigator; [Replaceable] readonly attribute Navigator clientInformation; readonly attribute Crypto crypto; [DoNotCheckSecurity, CustomSetter, Unforgeable] attribute Location location; [Replaceable, CustomGetter] readonly attribute Event event; DOMSelection getSelection(); [CheckSecurityForNode] readonly attribute Element frameElement; [DoNotCheckSecurity, CallWith=ScriptExecutionContext, ForwardDeclareInHeader] void focus(); [DoNotCheckSecurity, ForwardDeclareInHeader] void blur(); [DoNotCheckSecurity, CallWith=ScriptExecutionContext, ForwardDeclareInHeader] void close(); void print(); void stop(); [Custom] DOMWindow open(DOMString url, DOMString name, optional DOMString options); [Custom] any showModalDialog(DOMString url, optional any dialogArgs, optional DOMString featureArgs); void alert([Default=Undefined] optional DOMString message); boolean confirm([Default=Undefined] optional DOMString message); [TreatReturnedNullStringAs=Null] DOMString prompt([Default=Undefined] optional DOMString message, [TreatNullAs=NullString, TreatUndefinedAs=NullString,Default=Undefined] optional DOMString defaultValue); boolean find([Default=Undefined] optional DOMString string, [Default=Undefined] optional boolean caseSensitive, [Default=Undefined] optional boolean backwards, [Default=Undefined] optional boolean wrap, [Default=Undefined] optional boolean wholeWord, [Default=Undefined] optional boolean searchInFrames, [Default=Undefined] optional boolean showDialog); [Replaceable] readonly attribute boolean offscreenBuffering; [Replaceable] readonly attribute long outerHeight; [Replaceable] readonly attribute long outerWidth; [Replaceable] readonly attribute long innerHeight; [Replaceable] readonly attribute long innerWidth; [Replaceable] readonly attribute long screenX; [Replaceable] readonly attribute long screenY; [Replaceable] readonly attribute long screenLeft; [Replaceable] readonly attribute long screenTop; [Replaceable] readonly attribute long scrollX; [Replaceable] readonly attribute long scrollY; readonly attribute long pageXOffset; readonly attribute long pageYOffset; void scrollBy([Default=Undefined] optional long x, [Default=Undefined] optional long y); void scrollTo([Default=Undefined] optional long x, [Default=Undefined] optional long y); void scroll([Default=Undefined] optional long x, [Default=Undefined] optional long y); void moveBy([Default=Undefined] optional unrestricted float x, [Default=Undefined] optional unrestricted float y); // FIXME: this should take longs not floats. void moveTo([Default=Undefined] optional unrestricted float x, [Default=Undefined] optional unrestricted float y); // FIXME: this should take longs not floats. void resizeBy([Default=Undefined] optional unrestricted float x, [Default=Undefined] optional unrestricted float y); // FIXME: this should take longs not floats. void resizeTo([Default=Undefined] optional unrestricted float width, [Default=Undefined] optional unrestricted float height); // FIXME: this should take longs not floats. [DoNotCheckSecurity, ForwardDeclareInHeader] readonly attribute boolean closed; [Replaceable, DoNotCheckSecurityOnGetter] readonly attribute unsigned long length; attribute DOMString name; attribute DOMString status; attribute DOMString defaultStatus; #if defined(LANGUAGE_JAVASCRIPT) && LANGUAGE_JAVASCRIPT // This attribute is an alias of defaultStatus and is necessary for legacy uses. [ImplementedAs=defaultStatus] attribute DOMString defaultstatus; #endif // Self referential attributes [Replaceable, DoNotCheckSecurityOnGetter] readonly attribute DOMWindow self; [DoNotCheckSecurity, Unforgeable] readonly attribute DOMWindow window; [Replaceable, DoNotCheckSecurityOnGetter] readonly attribute DOMWindow frames; [Replaceable, DoNotCheckSecurityOnGetter] readonly attribute DOMWindow opener; [Replaceable, DoNotCheckSecurityOnGetter] readonly attribute DOMWindow parent; [DoNotCheckSecurityOnGetter, Unforgeable] readonly attribute DOMWindow top; // DOM Level 2 AbstractView Interface [Unforgeable] readonly attribute Document document; // CSSOM View Module MediaQueryList matchMedia(DOMString query); // styleMedia has been removed from the CSSOM View specification. readonly attribute StyleMedia styleMedia; // DOM Level 2 Style Interface CSSStyleDeclaration getComputedStyle([Default=Undefined] optional Element element, [TreatNullAs=NullString, TreatUndefinedAs=NullString,Default=Undefined] optional DOMString pseudoElement); // WebKit extensions #if defined(LANGUAGE_JAVASCRIPT) && LANGUAGE_JAVASCRIPT CSSRuleList getMatchedCSSRules([Default=Undefined] optional Element element, [TreatNullAs=NullString, TreatUndefinedAs=NullString,Default=Undefined] optional DOMString pseudoElement); #endif [Replaceable] readonly attribute unrestricted double devicePixelRatio; WebKitPoint webkitConvertPointFromPageToNode([Default=Undefined] optional Node node, [Default=Undefined] optional WebKitPoint p); WebKitPoint webkitConvertPointFromNodeToPage([Default=Undefined] optional Node node, [Default=Undefined] optional WebKitPoint p); readonly attribute DOMApplicationCache applicationCache; [GetterRaisesException] readonly attribute Storage sessionStorage; [GetterRaisesException] readonly attribute Storage localStorage; // This is the interface orientation in degrees. Some examples are: // 0 is straight up; -90 is when the device is rotated 90 clockwise; // 90 is when rotated counter clockwise. [Conditional=ORIENTATION_EVENTS] readonly attribute long orientation; // cross-document messaging #if defined(LANGUAGE_JAVASCRIPT) && LANGUAGE_JAVASCRIPT [DoNotCheckSecurity, Custom, RaisesException, ForwardDeclareInHeader] void postMessage(SerializedScriptValue message, DOMString targetOrigin, optional Array messagePorts); #else // There's no good way to expose an array via the ObjC bindings, so for now just allow passing in a single port. [DoNotCheckSecurity, Custom, RaisesException, ForwardDeclareInHeader] void postMessage(SerializedScriptValue message, optional MessagePort messagePort, DOMString targetOrigin); #endif [Conditional=WEB_TIMING, Replaceable] readonly attribute Performance performance; [Conditional=REQUEST_ANIMATION_FRAME] long requestAnimationFrame(RequestAnimationFrameCallback callback); [Conditional=REQUEST_ANIMATION_FRAME] void cancelAnimationFrame(long id); [Conditional=REQUEST_ANIMATION_FRAME] long webkitRequestAnimationFrame(RequestAnimationFrameCallback callback); [Conditional=REQUEST_ANIMATION_FRAME, ImplementedAs=cancelAnimationFrame] void webkitCancelAnimationFrame(long id); [Conditional=REQUEST_ANIMATION_FRAME, ImplementedAs=cancelAnimationFrame] void webkitCancelRequestAnimationFrame(long id); // This is a deprecated alias for webkitCancelAnimationFrame(). Remove this when removing vendor prefix. [Replaceable] readonly attribute DOMWindowCSS CSS; void captureEvents(/*in long eventFlags*/); void releaseEvents(/*in long eventFlags*/); #if defined(LANGUAGE_JAVASCRIPT) && LANGUAGE_JAVASCRIPT // Additional constructors. [CustomGetter, CustomConstructor] attribute HTMLImageElementNamedConstructor Image; // Usable with new operator attribute DOMTokenListConstructor DOMSettableTokenList; // Map DOMSettableTokenList to DOMTokenList for backward compatibility. [Conditional=IOS_TOUCH_EVENTS, CustomGetter] attribute TouchConstructor Touch; // Usable with the new operator [Conditional=IOS_TOUCH_EVENTS, CustomGetter] attribute TouchListConstructor TouchList; // Usable with the new operator attribute DOMURLConstructor webkitURL; // FIXME: deprecate this. attribute MutationObserverConstructor WebKitMutationObserver; // FIXME: Add metrics to determine when we can remove this. [Conditional=INDEXED_DATABASE, EnabledAtRuntime=IndexedDB] attribute IDBCursorConstructor webkitIDBCursor; [Conditional=INDEXED_DATABASE, EnabledAtRuntime=IndexedDB] attribute IDBDatabaseConstructor webkitIDBDatabase; [Conditional=INDEXED_DATABASE, EnabledAtRuntime=IndexedDB] attribute IDBFactoryConstructor webkitIDBFactory; [Conditional=INDEXED_DATABASE, EnabledAtRuntime=IndexedDB] attribute IDBIndexConstructor webkitIDBIndex; [Conditional=INDEXED_DATABASE, EnabledAtRuntime=IndexedDB] attribute IDBKeyRangeConstructor webkitIDBKeyRange; [Conditional=INDEXED_DATABASE, EnabledAtRuntime=IndexedDB] attribute IDBObjectStoreConstructor webkitIDBObjectStore; [Conditional=INDEXED_DATABASE, EnabledAtRuntime=IndexedDB] attribute IDBRequestConstructor webkitIDBRequest; [Conditional=INDEXED_DATABASE, EnabledAtRuntime=IndexedDB] attribute IDBTransactionConstructor webkitIDBTransaction; #endif // defined(LANGUAGE_JAVASCRIPT) // Event Handlers // Unique to Element and DOMWindow // FIXME: Should these be exposed on Document as well (and therefore moved to GlobalEventHandlers.idl)? [NotEnumerable] attribute EventHandler onanimationend; [NotEnumerable] attribute EventHandler onanimationiteration; [NotEnumerable] attribute EventHandler onanimationstart; [NotEnumerable] attribute EventHandler ontransitionend; [NotEnumerable] attribute EventHandler onwebkitanimationend; [NotEnumerable] attribute EventHandler onwebkitanimationiteration; [NotEnumerable] attribute EventHandler onwebkitanimationstart; [NotEnumerable] attribute EventHandler onwebkittransitionend; [NotEnumerable, Conditional=IOS_GESTURE_EVENTS] attribute EventHandler ongesturechange; [NotEnumerable, Conditional=IOS_GESTURE_EVENTS] attribute EventHandler ongestureend; [NotEnumerable, Conditional=IOS_GESTURE_EVENTS] attribute EventHandler ongesturestart; // Unique to DOMWindow [NotEnumerable, Conditional=DEVICE_ORIENTATION] attribute EventHandler ondevicemotion; [NotEnumerable, Conditional=DEVICE_ORIENTATION] attribute EventHandler ondeviceorientation; [NotEnumerable, Conditional=PROXIMITY_EVENTS] attribute EventHandler onwebkitdeviceproximity; }; DOMWindow implements GlobalEventHandlers; DOMWindow implements WindowBase64; DOMWindow implements WindowEventHandlers; DOMWindow implements WindowTimers;