| /* |
| * Copyright (C) 2006, 2007, 2008, 2009 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 COMPUTER, 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 COMPUTER, 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. |
| */ |
| |
| // HTML 5 draft spec: |
| // http://www.w3.org/html/wg/drafts/html/master/browsers.html#window |
| // FIXME: explain all uses of [DoNotCheckSecurity] |
| [ |
| CheckSecurity=Frame, |
| Custom=ToV8, |
| ImplementedAs=LocalDOMWindow, |
| PrimaryGlobal, |
| WillBeGarbageCollected, |
| ] interface Window : EventTarget { |
| // DOM Level 0 |
| readonly attribute Screen screen; |
| readonly attribute History history; |
| [Replaceable, MeasureAs=BarPropLocationbar] readonly attribute BarProp locationbar; |
| [Replaceable, MeasureAs=BarPropMenubar] readonly attribute BarProp menubar; |
| [Replaceable, MeasureAs=BarPropPersonalbar] readonly attribute BarProp personalbar; |
| [Replaceable, MeasureAs=BarPropScrollbars] readonly attribute BarProp scrollbars; |
| [Replaceable, MeasureAs=BarPropStatusbar] readonly attribute BarProp statusbar; |
| [Replaceable, MeasureAs=BarPropToolbar] readonly attribute BarProp toolbar; |
| [LogActivity=GetterOnly] readonly attribute Navigator navigator; |
| [Replaceable] readonly attribute Navigator clientInformation; |
| [DoNotCheckSecurity, Unforgeable, Replaceable, PutForwards=href] readonly attribute Location location; |
| [Custom, MeasureAs=WindowEvent, NotEnumerable] attribute Event event; |
| |
| Selection getSelection(); |
| |
| [CheckSecurity=Node, Custom=Getter] readonly attribute Element frameElement; |
| |
| [DoNotCheckSecurity, CallWith=ExecutionContext] void focus(); |
| [DoNotCheckSecurity] void blur(); |
| [DoNotCheckSecurity, CallWith=ExecutionContext] void close(); |
| |
| void print(); |
| void stop(); |
| |
| [Custom] Window open(DOMString url, |
| DOMString name, |
| optional DOMString options); |
| |
| [RuntimeEnabled=ShowModalDialog, Custom] any showModalDialog(DOMString url, |
| optional any dialogArgs, |
| optional DOMString featureArgs); |
| |
| void alert(); |
| void alert(DOMString message); |
| boolean confirm(optional DOMString message = ""); |
| DOMString? prompt(optional DOMString message = "", |
| 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, MeasureAs=WindowOffscreenBuffering] 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 double scrollX; |
| [Replaceable] readonly attribute double scrollY; |
| readonly attribute double pageXOffset; |
| readonly attribute double pageYOffset; |
| |
| // Overloading can be replaced by optional if RuntimeEnabled is removed, by |
| // changing the third argument to *optional* Dictionary scrollOptions |
| void scrollBy(double x, double y); |
| [RuntimeEnabled=CSSOMSmoothScroll, RaisesException] void scrollBy(double x, double y, ScrollOptions scrollOptions); |
| void scrollTo(double x, double y); |
| [RuntimeEnabled=CSSOMSmoothScroll, RaisesException] void scrollTo(double x, double y, ScrollOptions scrollOptions); |
| void scroll(double x, double y); |
| [RuntimeEnabled=CSSOMSmoothScroll, RaisesException] void scroll(double x, double y, ScrollOptions scrollOptions); |
| void moveBy([Default=Undefined] optional float x, [Default=Undefined] optional float y); // FIXME: this should take longs not floats. |
| void moveTo([Default=Undefined] optional float x, [Default=Undefined] optional float y); // FIXME: this should take longs not floats. |
| void resizeBy([Default=Undefined] optional float x, [Default=Undefined] optional float y); // FIXME: this should take longs not floats. |
| void resizeTo([Default=Undefined] optional float width, [Default=Undefined] optional float height); // FIXME: this should take longs not floats. |
| |
| [DoNotCheckSecurity] readonly attribute boolean closed; |
| |
| [Replaceable, DoNotCheckSecurity] readonly attribute unsigned long length; |
| |
| attribute DOMString name; |
| |
| attribute DOMString status; |
| [MeasureAs=WindowDefaultStatus] attribute DOMString defaultStatus; |
| // This attribute is an alias of defaultStatus and is necessary for legacy uses. |
| [ImplementedAs=defaultStatus, MeasureAs=WindowDefaultstatus] attribute DOMString defaultstatus; |
| |
| // Self referential attributes |
| [Replaceable, DoNotCheckSecurity] readonly attribute Window self; |
| [DoNotCheckSecurity, Unforgeable] readonly attribute Window window; |
| [Replaceable, DoNotCheckSecurity] readonly attribute Window frames; |
| |
| [DoNotCheckSecurity, Custom=Setter] attribute Window opener; |
| [Replaceable, DoNotCheckSecurity] readonly attribute Window parent; |
| [DoNotCheckSecurity, Unforgeable] readonly attribute Window top; |
| |
| // DOM Level 2 AbstractView Interface |
| 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, |
| [TreatUndefinedAs=NullString, Default=Undefined] optional DOMString? pseudoElement); |
| |
| // WebKit extensions |
| [MeasureAs=GetMatchedCSSRules] CSSRuleList getMatchedCSSRules([Default=Undefined] optional Element element, |
| [TreatUndefinedAs=NullString, Default=Undefined] optional DOMString? pseudoElement); |
| |
| [Replaceable] readonly attribute double devicePixelRatio; |
| |
| [RuntimeEnabled=ApplicationCache, LogActivity=GetterOnly] readonly attribute ApplicationCache applicationCache; |
| |
| [RuntimeEnabled=SessionStorage, LogActivity=GetterOnly, RaisesException=Getter] readonly attribute Storage sessionStorage; |
| [RuntimeEnabled=LocalStorage, LogActivity=GetterOnly, RaisesException=Getter] 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. |
| [RuntimeEnabled=OrientationEvent, MeasureAs=WindowOrientation] readonly attribute long orientation; |
| |
| [Replaceable] readonly attribute Console console; |
| |
| // cross-document messaging |
| [DoNotCheckSecurity, Custom, RaisesException] void postMessage(SerializedScriptValue message, DOMString targetOrigin, optional sequence<Transferable> transfer); |
| |
| [Replaceable] readonly attribute Performance performance; |
| |
| [MeasureAs=UnprefixedRequestAnimationFrame] long requestAnimationFrame(RequestAnimationFrameCallback callback); |
| void cancelAnimationFrame(long id); |
| [DeprecateAs=PrefixedRequestAnimationFrame] long webkitRequestAnimationFrame(RequestAnimationFrameCallback callback); |
| [DeprecateAs=PrefixedCancelAnimationFrame, ImplementedAs=cancelAnimationFrame] void webkitCancelAnimationFrame(long id); |
| [DeprecateAs=PrefixedCancelRequestAnimationFrame, ImplementedAs=cancelAnimationFrame] void webkitCancelRequestAnimationFrame(long id); |
| |
| [Replaceable] readonly attribute CSS CSS; |
| |
| // Event handler attributes |
| [RuntimeEnabled=CSSAnimationUnprefixed] attribute EventHandler onanimationend; |
| [RuntimeEnabled=CSSAnimationUnprefixed] attribute EventHandler onanimationiteration; |
| [RuntimeEnabled=CSSAnimationUnprefixed] attribute EventHandler onanimationstart; |
| [RuntimeEnabled=OrientationEvent] attribute EventHandler onorientationchange; |
| attribute EventHandler onsearch; |
| [RuntimeEnabled=Touch] attribute EventHandler ontouchcancel; |
| [RuntimeEnabled=Touch] attribute EventHandler ontouchend; |
| [RuntimeEnabled=Touch] attribute EventHandler ontouchmove; |
| [RuntimeEnabled=Touch] attribute EventHandler ontouchstart; |
| attribute EventHandler ontransitionend; |
| attribute EventHandler onwebkitanimationend; |
| attribute EventHandler onwebkitanimationiteration; |
| attribute EventHandler onwebkitanimationstart; |
| attribute EventHandler onwebkittransitionend; |
| attribute EventHandler onwheel; |
| |
| [MeasureAs=WindowCaptureEvents] void captureEvents(); |
| [MeasureAs=WindowReleaseEvents] void releaseEvents(); |
| |
| // Additional constructors. |
| [MeasureAs=PrefixedTransitionEventConstructor] attribute TransitionEventConstructor WebKitTransitionEvent; |
| [RuntimeEnabled=CSSAnimationUnprefixed] attribute WebKitAnimationEventConstructor AnimationEvent; |
| [MeasureAs=PrefixedWindowURL] attribute URLConstructor webkitURL; // FIXME: deprecate this. |
| [MeasureAs=PrefixedMutationObserverConstructor] attribute MutationObserverConstructor WebKitMutationObserver; |
| |
| // window.toString() requires special handling in V8 |
| [DoNotCheckSignature, DoNotCheckSecurity, Custom, NotEnumerable] stringifier; |
| |
| [NotEnumerable] getter Window (unsigned long index); |
| [Custom, NotEnumerable] getter Window (DOMString name); |
| }; |
| |
| // http://www.whatwg.org/specs/web-apps/current-work/#transferable-objects |
| // |
| // Expressing the Transferable typedef in IDL depends on http://crbug.com/240176. |
| // The postMessage() methods taking a Transferable array argument have custom |
| // binding code that is able to handle the Transferables that we currently |
| // recognize. To be able to declare a postMessage() signature that matches |
| // the implementation, we provide a Transferable typedef but with an |
| // incomplete type. |
| // |
| // FIXME: make this typedef accurate once enough of http://crbug.com/240176 |
| // is in place. |
| // FIXME: consider putting this typedef in an .idl file containing spec-wide |
| // utility type definitions. |
| typedef MessagePort Transferable; |
| |
| Window implements GlobalEventHandlers; |
| Window implements WindowBase64; |
| Window implements WindowEventHandlers; |
| Window implements WindowTimers; |