/* * 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 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;