/* * 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, ExportMacro=WEBCORE_EXPORT, ] 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=CallerWindow, ForwardDeclareInHeader] void focus(); [DoNotCheckSecurity, ForwardDeclareInHeader] void blur(); [DoNotCheckSecurity, CallWith=CallerDocument, 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); // FIXME: Using "undefined" as default parameter value is wrong. void alert(optional DOMString message = "undefined"); boolean confirm(optional DOMString message = "undefined"); DOMString? prompt(optional DOMString message = "undefined", optional DOMString? defaultValue = null); // FIXME: Using "undefined" as default parameter value is wrong. boolean find(optional DOMString string = "undefined", optional boolean caseSensitive = false, optional boolean backwards = false, optional boolean wrap = false, optional boolean wholeWord = false, optional boolean searchInFrames = false, optional boolean showDialog = false); [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(unrestricted double x, unrestricted double y); void scrollTo(unrestricted double x, unrestricted double y); [ImplementedAs=scrollTo] void scroll(unrestricted double x, unrestricted double y); #if defined(LANGUAGE_JAVASCRIPT) && LANGUAGE_JAVASCRIPT void scrollBy(optional ScrollToOptions option); void scrollTo(optional ScrollToOptions options); [ImplementedAs=scrollTo] void scroll(optional ScrollToOptions options); #endif void moveBy(optional unrestricted float x = NaN, optional unrestricted float y = NaN); // FIXME: this should take longs not floats. void moveTo(optional unrestricted float x = NaN, optional unrestricted float y = NaN); // FIXME: this should take longs not floats. void resizeBy(optional unrestricted float x = NaN, optional unrestricted float y = NaN); // FIXME: this should take longs not floats. void resizeTo(optional unrestricted float width = NaN, optional unrestricted float height = NaN); // 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(optional Element? element = null, optional DOMString? pseudoElement = null); // WebKit extensions #if defined(LANGUAGE_JAVASCRIPT) && LANGUAGE_JAVASCRIPT CSSRuleList getMatchedCSSRules(optional Element? element = null, optional DOMString? pseudoElement = null); #endif [Replaceable] readonly attribute unrestricted double devicePixelRatio; WebKitPoint webkitConvertPointFromPageToNode(optional Node? node = null, optional WebKitPoint? p = null); WebKitPoint webkitConvertPointFromNodeToPage(optional Node? node = null, optional WebKitPoint? p = null); 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. 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. attribute DOMURLConstructor webkitURL; // FIXME: deprecate this. attribute MutationObserverConstructor WebKitMutationObserver; // FIXME: Add metrics to determine when we can remove this. #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, ImplementedAs=onwebkitAnimationEnd] attribute EventHandler onwebkitanimationend; [NotEnumerable, ImplementedAs=onwebkitAnimationIteration] attribute EventHandler onwebkitanimationiteration; [NotEnumerable, ImplementedAs=onwebkitAnimationStart] attribute EventHandler onwebkitanimationstart; [NotEnumerable, ImplementedAs=onwebkitTransitionEnd] 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; }; // FIXME: Support ScrollBehavior. dictionary ScrollToOptions { unrestricted double left; unrestricted double top; }; DOMWindow implements GlobalEventHandlers; DOMWindow implements WindowEventHandlers; DOMWindow implements WindowOrWorkerGlobalScope;