Skip to content
This repository has been archived by the owner on Jul 30, 2019. It is now read-only.

Port WindowOrWorkerGlobalScope mixin. (#522) #593

Merged
merged 1 commit into from
Sep 22, 2016
Merged

Port WindowOrWorkerGlobalScope mixin. (#522) #593

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
93 changes: 64 additions & 29 deletions sections/webappapis.include
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1979,21 +1979,78 @@
must act as if, for the purposes of <a>event dispatching</a>,
the <code>Window</code> object is the parent of the <code>Document</code> object. [[!DOM]]

<h3 id="base64-utility-methods">Base64 utility methods</h3>
<h3 id="windoworworkerglobalscope-mixin">The WindowOrWorkerGlobalScope mixin</h3>

The <code>atob()</code> and <code>btoa()</code> methods allow authors to transform content to and from
the base64 encoding.
The {{WindowOrWorkerGlobalScope}} mixin is for use of APIs that are to be exposed
on {{Window}} and {{WorkerGlobalScope}} objects.

<p class="note">
Other standards are encouraged to further extend it using <code>partial interface
{{WindowOrWorkerGlobalScope}} { … };</code> along with an appropriate reference.
</p>

<pre class="idl" data-highlight="webidl" dfn-for="WindowOrWorkerGlobalScope">
typedef (DOMString or Function) TimerHandler;

<pre class="idl" data-highlight="webidl" dfn-for="WindowBase64">
[NoInterfaceObject, Exposed=(Window, Worker)]
interface WindowBase64 {
interface WindowOrWorkerGlobalScope {
[Replaceable] readonly attribute USVString origin;

// Base64 utility methods (WindowBase64)
DOMString btoa(DOMString btoa);
DOMString atob(DOMString atob);

// Timers (WindowTimers)
long setTimeout((Function or DOMString) handler, optional long timeout = 0, any... arguments);
void clearTimeout(optional long handle = 0);
long setInterval((Function or DOMString) handler, optional long timeout = 0, any... arguments);
void clearInterval(optional long handle = 0);

// ImageBitmap, Images (ImageBitmapFactories)
Promise&lt;ImageBitmap&gt; createImageBitmap(ImageBitmapSource image);
Promise&lt;ImageBitmap&gt; createImageBitmap(ImageBitmapSource image, long sx, long sy, long sw, long sh);
};
Window implements WindowBase64;
WorkerGlobalScope implements WindowBase64;
Window implements WindowOrWorkerGlobalScope;
WorkerGlobalScope implements WindowOrWorkerGlobalScope;
</pre>

<dl class="domintro">
<dt><var>origin</var> = <var>self</var> . <var>origin</var></dt>
<dd>
Returns the global object's origin, serialized as string.
</dd>
</dl>

<div class="example">
Developers are strongly encouraged to use <code>self.origin</code> over
<code>location.origin</code>. <code>self.origin</code> returns the origin of the
environment, while <code>location.origin</code> returns URL of the environment.

Imagine the following script executing in a document on https://example.com:

<pre>
var frame = document.createElement("iframe")
frame.onload = function() {
var frameWin = frame.contentWindow
console.log(frameWin.location.origin) // "null"
console.log(frameWin.origin) // "https://example.com"
}
document.body.appendChild(frame)
</pre>

<code>self.origin</code> is a more reliable security indicator.
</div>

The <code>origin</code> attribute's getter must return this object's relevant
setting object's origin, serialized.

<!-- TODO: origin and serialized references are missing. -->

<h3 id="base64-utility-methods">Base64 utility methods</h3>

The <code>atob()</code> and <code>btoa()</code> methods allow authors to transform content to and from
the base64 encoding.

<p class="note">
In these APIs, for mnemonic purposes, the "b" can be considered to stand for
"binary", and the "a" for "ASCII". In practice, though, for primarily historical reasons, both the
Expand Down Expand Up @@ -2538,18 +2595,6 @@
and <code>setInterval()</code>
methods allow authors to schedule timer-based callbacks.

<pre class="idl" data-highlight="webidl" dfn-for="WindowTimers">
[NoInterfaceObject, Exposed=(Window,Worker)]
interface WindowTimers {
long setTimeout((Function or DOMString) handler, optional long timeout = 0, any... arguments);
void clearTimeout(optional long handle = 0);
long setInterval((Function or DOMString) handler, optional long timeout = 0, any... arguments);
void clearInterval(optional long handle = 0);
};
Window implements WindowTimers;
WorkerGlobalScope implements WindowTimers;
</pre>

<dl class="domintro">

<dt><var>handle</var> = <var>window</var> . <code>setTimeout</code>( <var>handler</var> [, <var>timeout</var> [, <var>arguments</var>... ] ] )</dt>
Expand Down Expand Up @@ -4522,16 +4567,6 @@
ImageBitmap) ImageBitmapSource;
</pre>

<pre class="idl" data-highlight="webidl" dfn-for="ImageBitmapFactories">
[NoInterfaceObject, Exposed=(Window, Worker)]
interface ImageBitmapFactories {
Promise&lt;ImageBitmap&gt; createImageBitmap(ImageBitmapSource image);
Promise&lt;ImageBitmap&gt; createImageBitmap(ImageBitmapSource image, long sx, long sy, long sw, long sh);
};
Window implements ImageBitmapFactories;
WorkerGlobalScope implements ImageBitmapFactories;
</pre>

An <code>ImageBitmap</code> object represents a bitmap image that can be painted to a canvas
without undue latency.

Expand Down