7.1.2.1 Navigating auxiliary browsing contexts in the DOM
TheopenerIDL attribute on theWindowp758
object, on getting, must return theWindowProxyp765
object of thebrowsing contextp748
from which the
currentbrowsing contextp748
was created (itsopener browsing contextp750
), if there is one, if it is still available, and if the currentbrowsing contextp748
has notdisowned its openerp751
; otherwise, it must return null. On setting, if the new value is null then the currentbrowsing contextp748
mustdisown
its opener; if the new value is anything else then the user agent must call the [[DefineOwnProperty]] internal method of theWindowp758
object,
passing the property name "opener" as the property key, and the Property Descriptor { [[Value]]:value, [[Writable]]: true, [[Enumerable]]: true,
[[Configurable]]: true } as the property descriptor, wherevalueis the new value.
Abrowsing contextp748
Aisfamiliar witha secondbrowsing contextp748
Bif one of the following conditions is true:
• Either theoriginp767
of theactive documentp748
ofAis thesamep769
as theoriginp767
of theactive documentp748
ofB, or
• The browsing contextAis anested browsing contextp749
with atop-level browsing contextp749
, and itstop-level browsing contextp749
isB,
or
• The browsing contextBis anauxiliary browsing contextp750
andAisfamiliar withp751
B'sopener browsing contextp750
, or
• The browsing contextBis not atop-level browsing contextp749
, but there exists anancestor browsing contextp749
ofBwhoseactive
documentp748
has thesamep769
originp767
as theactive documentp748
ofA(possibly in fact beingAitself).
Abrowsing contextp748
Aisallowed to navigatea secondbrowsing contextp748
Bif the following algorithm terminates positively:
1. IfAis not the samebrowsing contextp748
asB, andAis not one of theancestor browsing contextsp749
ofB, andBis not atop-level
browsing contextp749
, andA'sactive documentp748
'sactive sandboxing flag setp773
has itssandboxed navigation browsing context flagp771
set, then abort these steps negatively.
2. Otherwise, ifBis atop-level browsing contextp749
, and is one of theancestor browsing contextsp749
ofA, andA'sactive documentp748
's
active sandboxing flag setp773
has itssandboxed top-level navigation browsing context flagp771
set, then abort these steps negatively.
3. Otherwise, ifBis atop-level browsing contextp749
, and is neitherAnor one of theancestor browsing contextsp749
ofA, andA's
Documentp103
'sactive sandboxing flag setp773
has itssandboxed navigation browsing context flagp771
set, andAis not theone permitted
sandboxed navigatorp771
ofB, then abort these steps negatively.
4. Otherwise, terminate positively!
An element has abrowsing context scope originif itsDocumentp103
'sbrowsing contextp748
is atop-level browsing contextp749
or if all of its
Documentp103
'sancestor browsing contextsp749
all haveactive documentsp748
whoseoriginp767
are thesame originp769
as the element'snode
document
'soriginp767
. If an element has abrowsing context scope originp751
, then its value is theoriginp767
of the element'snode document
.
Eachbrowsing contextp748
is defined as having a list of one or moredirectly reachable browsing contexts. These are:
• Thebrowsing contextp748
itself.
• All thebrowsing contextp748
'schild browsing contextsp749
.
• Thebrowsing contextp748
'sparent browsing contextp749
.
• All thebrowsing contextsp748
that have thebrowsing contextp748
as theiropener browsing contextp750
.
• Thebrowsing contextp748
'sopener browsing contextp750
.
The transitive closure of all thebrowsing contextsp748
that aredirectly reachable browsing contextsp751
forms aunit of related browsing contexts.
7.1.3 Security
7.1.4 Groupings of browsing contexts
751
Pdf form data extraction - extract form data from PDF in C#.net, ASP.NET, MVC, Ajax, WPF
Help to Read and Extract Field Data from PDF with a Convenient C# Solution
how to make a pdf form fillable in reader; pdf data extraction open source
Pdf form data extraction - VB.NET PDF Form Data Read library: extract form data from PDF in vb.net, ASP.NET, MVC, Ajax, WPF
Convenient VB.NET Solution to Read and Extract Field Data from PDF
extracting data from pdf files; saving pdf forms in acrobat reader
Eachunit of related browsing contextsp751
is then further divided into the smallest number of groups such that every member of each group has an
active documentp748
with anoriginp767
that, through appropriate manipulation of thedocument.domainp770
attribute, could be made to besame
origin-domainp769
with other members of the group, but could not be made the same as members of any other group. Each such group is aunit of
related similar-origin browsing contexts.
Browsing contexts can have abrowsing context name. By default, a browsing context has no name (its name is not set).
Avalid browsing context nameis any string with at least one character that does not start with a U+005F LOW LINE character. (Names starting
with an underscore are reserved for special keywords.)
Avalid browsing context name or keywordis any string that is either avalid browsing context namep752
or that is anASCII case-insensitivep63
match for one of:_blank,_self,_parent, or_top.
These values have different meanings based on whether the page is sandboxed or not, as summarised in the following (non-normative) table. In
this table, "current" means thebrowsing contextp748
that the link or script is in, "parent" means theparent browsing contextp749
of the one the link or
script is in, "top" means thetop-level browsing contextp749
of the one the link or script is in, "new" means a newtop-level browsing contextp749
or
auxiliary browsing contextp750
is to be created, subject to various user preferences and user agent policies, "none" means that nothing will happen,
and "maybe new" means the same as "new" if the "allow-popupsp772
" keyword is also specified on thesandboxp312
attribute (or if the user
overrode the sandboxing), and the same as "none" otherwise.
Effect in aniframep308
with...
Keyword
Ordinary effect
sandbox=""
sandbox="allow-top-
navigation"
none specified, for links and form submissions
current
current
current
empty string
current
current
current
_blank
new
maybe new
maybe new
_self
current
current
current
_parentif there isn't a parent
current
current
current
_parentif parent is also top
parent/top
none
parent/top
_parentif there is one and it's not top
parent
none
none
_topif top is current
current
current
current
_topif top is not current
top
none
top
name that doesn't exist
new
maybe new
maybe new
name that exists and is a descendant
specified
descendant
specified
descendant
specified descendant
name that exists and is current
current
current
current
name that exists and is an ancestor that is top
specified ancestor
none
specified ancestor/top
name that exists and is an ancestor that is not top
specified ancestor
none
none
other name that exists with common top
specified
none
none
name that exists with different top, iffamiliarp751
andone permitted sandboxed navigatorp771
specified
specified
specified
name that exists with different top, iffamiliarp751
but notone permitted sandboxed
navigatorp771
specified
none
none
name that exists with different top, notfamiliarp751
new
maybe new
maybe new
Most of the restrictions on sandboxed browsing contexts are applied by other algorithms, e.g. thenavigationp788
algorithm, notthe rules for choosing a browsing
context given a browsing context name
p753
given below.
An algorithm isallowed to show a popupif any of the following conditions is true:
• Thetaskp842
in which the algorithm is running is currently processing anactivation behaviourp710
whoseclick
event wastrustedp44
.
There is also at most oneevent loopp842
perunit of related similar-origin browsing contextsp752
(though severalunits of related similar-origin
browsing contextsp752
can have a sharedevent loopp842
).
Note
7.1.5 Browsing context names
752
VB.NET PDF Text Extract Library: extract text content from PDF
control provides text extraction from PDF images and image files. Enable extracting PDF text to another PDF file, and other formats such as TXT and SVG form.
extracting data from pdf forms to excel; exporting data from pdf to excel
C# PDF Text Extract Library: extract text content from PDF file in
Image text extraction control provides text extraction from PDF images and image files. Best C#.NET PDF text extraction library and component for free download.
cannot save pdf form in reader; exporting pdf form to excel
• Thetaskp842
in which the algorithm is running is currently running the event listener for atrustedp44
event whose type is in the following
list:
◦ changep1154
◦ click
◦ dblclick
◦ mouseup
◦ resetp1155
◦ submitp1155
• Thetaskp842
in which the algorithm is running wasqueuedp843
by an algorithm that wasallowed to show a popupp752
, and the chain of
such algorithms started within a user-agent defined timeframe.
The rules for choosing a browsing context given a browsing context nameare as follows. The rules assume that they are being applied in the
context of abrowsing contextp748
, as part of the execution of ataskp842
.
1. If the given browsing context name is the empty string or_self, then the chosen browsing context must be the current one.
2. If the given browsing context name is_parent, then the chosen browsing context must be theparentbrowsing contextp749
of the
current one, unless there isn't one, in which case the chosen browsing context must be the current browsing context.
3. If the given browsing context name is_top, then the chosen browsing context must be thetop-level browsing contextp749
of the current
one, if there is one, or else the current browsing context.
4. If the given browsing context name is not_blankand there exists a browsing context whosenamep752
is the same as the given
browsing context name, and the current browsing context isfamiliar withp751
that browsing context, and the user agent determines that
the two browsing contexts are related enough that it is ok if they reach each other, then that browsing context must be the chosen one. If
there are multiple matching browsing contexts, the user agent should select one in some arbitrary consistent manner, such as the most
recently opened, most recently focused, or more closely related.
5. Otherwise, a new browsing context is being requested, and what happens depends on the user agent's configuration and abilities — it is
determined by the rules given for the first applicable option from the following list:
If the algorithm is notallowed to show a popupp752
and the user agent has been configured to not show popups (i.e. the
user agent has a "popup blocker" enabled)
There is no chosen browsing context. The user agent may inform the user that a popup has been blocked.
If the current browsing context'sactive documentp748
'sactive sandboxing flag setp773
has thesandboxed auxiliary
navigation browsing context flagp771
set.
Typically, there is no chosen browsing context.
The user agent may offer tocreatep748
a newtop-level browsing contextp749
or reuse an existingtop-level browsing
contextp749
. If the user picks one of those options, then the designated browsing context must be the chosen one (the
browsing context's name isn't set to the given browsing context name). The default behaviour (if the user agent doesn't offer
the option to the user, or if the user declines to allow a browsing context to be used) must be that there must not be a chosen
browsing context.
If the user agent has been configured such that in this instance it will create a new browsing context:
A newauxiliary browsing contextp750
must be created, with theopener browsing contextp750
being the current one. If the given
browsing context name is not_blank, then the new auxiliary browsing context's name must be the given browsing context
name (otherwise, it has no name). The chosen browsing context must be this new browsing context.
For example, if a user clicked a button, it might be acceptable for a popup to result from that after 4 seconds, but it would
likely not be acceptable for a popup to result from that after 4 hours.
Example
If this case occurs, it means that an author has explicitly sandboxed the document that is trying to
open a link.
⚠Warning!
If the newly createdbrowsing contextp748
is immediatelynavigatedp788
, then the navigation will be done with
replacement enabledp800
.
Note
753
VB.NET PDF Image Extract Library: Select, copy, paste PDF images
image extraction from multiple page adobe PDF file in VB.NET. Extract multiple types of image from PDF file in VB.NET, like XObject Image, XObject Form, Inline
export excel to pdf form; pdf data extraction to excel
C# PDF Image Extract Library: Select, copy, paste PDF images in C#
Support PDF Image Extraction from a Page, a Region on a Page Extract various types of image from PDF file, like XObject Image, XObject Form, Inline Image
can reader edit pdf forms; how to save fillable pdf form in reader
If the user agent has been configured such that in this instance it will reuse the current browsing context
The chosen browsing context is the current browsing context.
If the user agent has been configured such that in this instance it will not find a browsing context
There must not be a chosen browsing context.
User agent implementors are encouraged to provide a way for users to configure the user agent to always reuse the current browsing
context.
If the current browsing context'sactive documentp748
'sactive sandboxing flag setp773
has both thesandboxed navigation browsing
context flagp771
andsandbox propagates to auxiliary browsing contexts flagp772
set, and the chosen browsing context picked above, if
any, is a new browsing context, then all the flags that are set in the current browsing context'sactive documentp748
'sactive sandboxing
flag setp773
when the new browsing context is created must be set in the new browsing context'spopup sandboxing flag setp773
, and the
current browsing context must be set as the new browsing context'sone permitted sandboxed navigatorp771
.
When the user agent is required toset up a browsing context environment settings object, given aJavaScript execution context
execution
context, it must run the following steps:
1. Letrealmbe the value ofexecution context's Realm component.
2. Letwindowberealm'sglobal objectp834
.
3. Leturlbe a copy of theURL
of theDocumentp103
with whichwindowassociated.
4. Letsettings objectbe a newenvironment settings objectp828
whose algorithms are defined as follows:
Therealm execution contextp828
Returnexecution context.
Themodule mapp838
Return themodule mapp104
of theDocumentp103
with whichwindowis currently associated.
Theresponsible browsing contextp828
Return thebrowsing contextp748
with whichwindowis associated.
Theresponsible event loopp828
Return theevent loopp842
that is associated with theunit of related similar-origin browsing contextsp752
to whichwindow'sbrowsing
contextp748
belongs.
Theresponsible documentp828
Return theDocumentp103
with whichwindowis currently associated.
TheAPI URL character encodingp828
Return the currentcharacter encoding
of theDocumentp103
with whichwindowis currently associated.
TheAPI base URLp828
Return the currentbase URLp86
of theDocumentp103
with whichwindowis currently associated.
Theoriginp767
Return theoriginp767
of theDocumentp103
with whichwindowis currently associated.
Thecreation URLp828
Returnurl.
TheHTTPS statep829
Return theHTTPS statep104
of theDocumentp103
with whichwindowis currently associated.
7.1.6 Script settings for browsing contexts
754
VB.NET PDF Page Extract Library: copy, paste, cut PDF pages in vb.
VB.NET PDF - PDF File Pages Extraction Guide. Detailed VB.NET Guide for Extracting Pages from Microsoft PDF Doc. Free PDF document
extract pdf form data to excel; how to fill out a pdf form with reader
VB.NET PDF Library SDK to view, edit, convert, process PDF file
PDF Text Extraction. Mature and robust APIs are provided for programmers to integrate and perform PDF text extraction feature in .NET windows and web project.
extract data out of pdf file; extract table data from pdf
5. Setrealm's [[HostDefined]] field tosettings object.
6. Returnsettings object.
7.2 Security infrastructure forWindow
p758
,WindowProxy
p765
, andLocation
p781
objects
Although typically objects cannot be accessed acrossoriginsp767
, the web platform would not be true to itself if it did not have some legacy
exceptions to that rule that the web depends upon.
Whenperform a security check
is invoked, with aplatformObject,realm,identifier, andtype, run these steps:
1. IfplatformObjectis aWindowp758
orLocationp781
object, then:
1. Repeat for eachethat is an element ofCrossOriginPropertiesp755
(platformObject):
1. IfSameValue
(e.[[Property]],identifier) is true, then:
1. Iftypeis "method" andehas neither [[NeedsGet]] nor [[NeedsGet]], then return.
2. Otherwise, iftypeis "getter" ande.[[NeedsGet]] is true, then return.
3. Otherwise, iftypeis "setter" ande.[[NeedsSet]] is true, then return.
2. IfIsPlatformObjectSameOriginp756
(platformObject) is false, then throw a"SecurityError"
DOMException
.
Windowp758
andLocationp781
objects both have a [[CrossOriginPropertyDescriptorMap]] internal slot, whose value is initially an empty map.
User agents should allow a value held in the map to be garbage collected along with its corresponding key when nothing holds a reference to any
part of the value. That is, as long as garbage collection is not observable.
User agents may have an optimization whereby they remove key-value pairs from the map whendocument.domainp770
is set. This is not
observable asdocument.domainp770
cannot revisit an earlier value.
7.2.3.1CrossOriginProperties(O)
1. Assert:Ois aLocationp781
orWindowp758
object.
The [[CrossOriginPropertyDescriptorMapp755
]] internal slot contains a map with entries whose keys are (currentOrigin,objectOrigin,
propertyKey)-tuples and values are property descriptors, as a memoization of what is visible to scripts whencurrentOrigininspects a
Windowp758
orLocationp781
object fromobjectOrigin. It is filled lazily byCrossOriginGetOwnPropertyHelperp756
, which consults it on
future lookups.
Note
For example, withconst href = Object.getOwnPropertyDescriptor(crossOriginLocation, "href").setthe value
and its corresponding key in the map cannot be garbage collected as that would be observable.
Example
For example, settingdocument.domainp770
to "example.com" on www.example.com means user agents can remove all key-value
pairs from the map where part of the key is www.example.com, as that can never be part of theoriginp767
again and therefore the
corresponding value could never be retrieved from the map.
Example
7.2.1 Integration with IDL
7.2.2 Shared internal slot: [[CrossOriginPropertyDescriptorMap]]
7.2.3 Shared abstract operations
755
C# PDF File Permission Library: add, remove, update PDF file
Data. Data: Auto Fill-in Field Data. Field: Insert Choose to offer PDF annotation and content extraction Enable or disable copying and form filling functions.
pdf data extraction tool; extract pdf form data to xml
VB.NET PDF File Permission Library: add, remove, update PDF file
Data. Data: Auto Fill-in Field Data. Field: Insert Choose to offer PDF annotation and content extraction Enable or disable copying and form filling functions.
collect data from pdf forms; extract data from pdf using java
2. IfOis aLocationp781
object, then return « { [[Property]]: "href", [[NeedsGet]]: false, [[NeedsSet]]: true }, { [[Property]]: "replace" } ».
3. LetcrossOriginWindowPropertiesbe « { [[Property]]: "window", [[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "self",
[[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "location", [[NeedsGet]]: true, [[NeedsSet]]: true }, { [[Property]]: "close" }, {
[[Property]]: "closed", [[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "focus" }, { [[Property]]: "blur" }, { [[Property]]: "frames",
[[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "length", [[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "top",
[[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "opener", [[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "parent",
[[NeedsGet]]: true, [[NeedsSet]]: false }, { [[Property]]: "postMessage" } ».
4. Repeat for eachethat is an element of thechild browsing context name property setp762
:
1. Add { [[Property]]:e} as the last element ofcrossOriginWindowProperties.
5. ReturncrossOriginWindowProperties.
7.2.3.2IsPlatformObjectSameOrigin(O)
1. Return true if thecurrent settings objectp836
'soriginp767
issame origin-domainp769
withO'srelevant settings objectp837
'soriginp767
, and
false otherwise.
7.2.3.3CrossOriginGetOwnPropertyHelper(O,P)
1. IfPis@@toStringTagp52
,@@hasInstancep52
, or@@isConcatSpreadablep52
, then returnPropertyDescriptor
{ [[Value]]: undefined,
[[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true }.
2. LetcrossOriginKeybe a tuple consisting of thecurrent settings objectp836
'soriginp767
'seffective domainp768
,O'srelevant settings
objectp837
'soriginp767
'seffective domainp768
, andP.
3. Repeat for eachethat is an element ofCrossOriginPropertiesp755
(O):
1. IfSameValue
(e.[[Property]],P) is true, then:
1. If the value of the [[CrossOriginPropertyDescriptorMapp755
]] internal slot ofOcontains an entry whose key is
crossOriginKey, then return that entry's value.
2. LetoriginalDescbeOrdinaryGetOwnProperty
(O,P).
3. LetcrossOriginDescbeCrossOriginPropertyDescriptorp756
(e,originalDesc).
4. Create an entry in the value of the [[CrossOriginPropertyDescriptorMapp755
]] internal slot ofOwith key
crossOriginKeyand valuecrossOriginDesc.
5. ReturncrossOriginDesc.
4. Return undefined.
7.2.3.3.1CrossOriginPropertyDescriptor(crossOriginProperty,originalDesc)
1. IfcrossOriginProperty.[[NeedsGet]] andcrossOriginProperty.[[NeedsSet]] are absent, then:
1. LetvaluebeoriginalDesc.[[Value]].
2. IfIsCallable
(value) is true, setvaluetoCrossOriginFunctionWrapperp757
(true,value).
Indexed properties do not need to be safelisted as they are handled directly by theWindowProxyp765
object.
Note
If this abstract operation returns undefined and there is no custom behaviour, the caller needs to throw a"SecurityError"
DOMException
.
Note
756
C# PDF File Merge Library: Merge, append PDF files in C#.net, ASP.
Merge Microsoft Office Word, Excel and PowerPoint data to PDF form. PDF page deleting, PDF document splitting, PDF page reordering and PDF page image and
how to extract data from pdf to excel; html form output to pdf
VB.NET PDF Password Library: add, remove, edit PDF file password
passwordSetting.IsAnnot = True ' Allow to fill form. passwordSetting.IsFillForm = True ' Content extraction is allowed. True ' Add password to PDF file.
how to extract data from pdf file using java; how to type into a pdf form in reader
3. ReturnPropertyDescriptor
{ [[Value]]:value, [[Enumerable]]: false, [[Writable]]: false, [[Configurable]]: true }.
2. Otherwise:
1. LetcrossOriginGetbeCrossOriginFunctionWrapperp757
(crossOriginProperty.[[NeedsGet]],originalDesc.[[Get]]).
2. LetcrossOriginSetbeCrossOriginFunctionWrapperp757
(crossOriginProperty.[[NeedsSet]],originalDesc.[[Set]]).
3. ReturnPropertyDescriptor
{ [[Get]]:crossOriginGet, [[Set]]:crossOriginSet, [[Enumerable]]: false, [[Configurable]]: true }.
7.2.3.3.2CrossOriginFunctionWrapper(needsWrapping,functionToWrap)
1. IfneedsWrappingis false, then return undefined.
2. Return a newcross-origin wrapper functionp757
whose [[Wrapped]] internal slot isfunctionToWrap.
Across-origin wrapper functionis an anonymous built-in function that has a [[Wrapped]] internal slot.
When across-origin wrapper functionp757
Fis called with a list of argumentsargumentsList, the following steps are taken:
1. Assert:Fhas a [[Wrapped]] internal slot that is a function.
2. LetwrappedFunctionbe the [[Wrapped]] internal slot ofF.
3. Return ?Call
(wrappedFunction,this,argumentsList).
7.2.3.4CrossOriginGet(O,P,Receiver)
1. Letdescbe ?O.[[GetOwnProperty]](P).
2. Assert:descis not undefined.
3. IfIsDataDescriptor
(desc) is true, then returndesc.[[Value]].
4. Assert:IsAccessorDescriptor
(desc) is true.
5. Letgetterbedesc.[[Get]].
6. Ifgetteris undefined, throw a"SecurityError"
DOMException
.
7. Return ?Call
(getter,Receiver).
7.2.3.5CrossOriginSet(O,P,V,Receiver)
1. Letdescbe ?O.[[GetOwnProperty]](P).
2. Assert:descis not undefined.
3. IfIsAccessorDescriptor
(desc) is true, then:
1. Letsetterbedesc.[[Set]].
2. Ifsetteris undefined, return false.
3. Perform ?Call
(setter,Receiver, «V»).
Due to this being invoked from a differentoriginp767
, across-origin wrapper functionp757
will have a different value for
Function.prototypefrom the function being wrapped. This follows from how JavaScript creates anonymous built-in functions.
Note
757
4. Return true.
4. Return false.
7.2.3.6CrossOriginOwnPropertyKeys(O)
1. Letkeysbe a new emptyList
.
2. Repeat for eachethat is an element ofCrossOriginPropertiesp755
(O):
1. Adde.[[Property]] as the last element ofkeys.
3. Returnkeys.
7.3 TheWindow
p758
object
[PrimaryGlobal, LegacyUnenumerableNamedProperties]
/*sealed*/ interface Window w : EventTarget
{
// the current browsing context
[Unforgeable] readonly attribute WindowProxy
window
;
[Replaceable] readonly attribute WindowProxy
self
;
[Unforgeable] readonly attribute Document
document
;
attribute DOMString name
;
[PutForwards=href
, Unforgeable] readonly attribute Location
location
;
readonly attribute History
history
;
readonly attribute CustomElementsRegistry
customElements
;
[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
;
attribute DOMString status
;
void close
();
readonly attribute boolean closed
;
void stop
();
void focus
();
void blur
();
// other browsing contexts
[Replaceable] readonly attribute WindowProxy
frames
;
[Replaceable] readonly attribute unsigned long length
;
[Unforgeable] readonly attribute WindowProxy
top
;
attribute any opener
;
[Replaceable] readonly attribute WindowProxy
parent
;
readonly attribute Element
frameElement
;
WindowProxy
open
(optional DOMString url = "about:blank", optional DOMString target = "_blank",
[TreatNullAs=EmptyString] optional DOMString features = "", optional boolean replace = false);
getter
object
(DOMString name);
// Since this is the global object, the IDL named getter adds a NamedPropertiesObject exotic
// object on the prototype chain. Indeed, this does not make the global object an exotic object.
// Indexed access is taken care of by the WindowProxy
exotic object.
// the user agent
readonly attribute Navigator
navigator
;
IDL
758
readonly attribute ApplicationCache
applicationCache
;
// user prompts
void alert
();
void alert
(DOMString message);
boolean confirm
(optional DOMString message = "");
DOMString? prompt
(optional DOMString message = "", optional DOMString default = "");
void print
();
unsigned long requestAnimationFrame
(FrameRequestCallback
callback);
void cancelAnimationFrame
(unsigned long handle);
void postMessage
(any message, DOMString targetOrigin, optional sequence<object
> transfer = []);
// also has obsolete members
};
Window
implements GlobalEventHandlers
;
Window
implements WindowEventHandlers
;
callback FrameRequestCallback = void (DOMHighResTimeStamp
time);
Thewindow,frames, andselfIDL attributes must all return theWindowp758
object'sbrowsing contextp748
'sWindowProxyp765
object.
ThedocumentIDL attribute must returntheWindowobject's newestDocumentobjectp748
.
ThedefaultViewIDL attribute of theDocumentp103
interface must return theDocumentp103
'sbrowsing contextp748
'sWindowProxyp765
object, if
there is one, or null otherwise.
For historical reasons,Windowp758
objects must also have a writable, configurable, non-enumerable property namedHTMLDocumentwhose value
is theDocumentp103
interface object.
window.windowp759
window.framesp759
window.selfp759
These attributes all returnwindow.
window.documentp759
Returns theDocumentp103
associated withwindow.
document.defaultViewp759
Returns theWindowp758
object of theactive documentp748
.
Note
TheDocumentp103
object associated with aWindowp758
object can change in exactly one case: when thenavigatep788
algorithminitialises
a newDocumentobjectp793
for the first page loaded in abrowsing contextp748
. In that specific case, theWindowp758
object of the original
about:blankp50
page is reused and gets a newDocumentp103
object.
Note
Note
7.3.1 APIs for creating and navigating browsing contexts by name
759
Theopen()method onWindowp758
objects provides a mechanism fornavigatingp788
an existingbrowsing contextp748
or opening and navigating an
auxiliary browsing contextp750
.
When the method is invoked, the user agent must run the following steps:
1. Letentry settingsbe theentry settings objectp836
when the method was invoked.
2. Leturlbe the first argument.
3. Lettargetbe the second argument.
4. Letfeatures
be the third argument.
5. Letreplacebe the fourth argument.
6. Letsource browsing contextbe theresponsible browsing contextp828
specified byentry settings.
7. Iftargetis the empty string, let it be the string "_blank" instead.
8. If the user has indicated a preference for whichbrowsing contextp748
to navigate, follow these substeps:
1. Lettarget browsing contextbe thebrowsing contextp748
indicated by the user.
2. Iftarget browsing contextis a newtop-level browsing contextp749
, let thesource browsing contextbe set astarget browsing
context'sone permitted sandboxed navigatorp771
.
Otherwise, applythe rules for choosing a browsing context given a browsing context namep753
usingtargetas the name andsource
browsing contextas the context in which the algorithm is executed. If this results in there not being a chosen browsing context, then
throw an"InvalidAccessError"
DOMException
and abort these steps. Otherwise, lettarget browsing contextbe thebrowsing
contextp748
so obtained.
9. Iftarget browsing contextwas just created, either as part ofthe rules for choosing a browsing context given a browsing context namep753
or due to the user indicating a preference for navigating a newtop-level browsing contextp749
, then letnewbe true. Otherwise, let it be
false.
10. Interpretfeaturesas defined in the CSSOM View specification.[CSSOMVIEW]p1159
window=window.openp760( [url[,target[,features[,replace] ] ] ] )
Opens a window to showurl(defaults toabout:blankp50
), and returns it. Thetargetargument gives the name of the new window. If a
window exists with that name already, it is reused. Thereplaceattribute, if true, means that whatever page is currently open in that
window will be removed from the window's session history. Thefeatures
argument can be used to influence the rendering of the new
window.
window.namep761 [ =value]
Returns the name of the window.
Can be set, to change the name.
window.closep761()
Closes the window.
window.closedp761
Returns true if the window has been closed, false otherwise.
window.stopp761()
Cancels the document load.
For example, suppose there is a user agent that supports control-clicking a link to open it in a new tab. If a user clicks in that
user agent on an element whoseonclickp850
handler uses thewindow.open()p760
API to open a page in an iframe, but,
while doing so, holds the control key down, the user agent could override the selection of the target browsing context to
instead target a new tab.
Example
760
Documents you may be interested
Documents you may be interested