MDN の最近のリビジョン

Tools/Debugger-API/Debugger (en-US)

2017-07-28T14:45:16-07:00

Edited by:

jimblandy

<h3>Content changes:</h3>

	Revision 1181587			Revision 1278951
n			n	7	<h1 id="the-debugger-object">
				8	The Debugger Object
				9	</h1>
n	12	<code>new Debugger([<em>global</em>, …])</code>	n	15	<code>new Debugger([<i>global</i>, …])</code>
	13	</dt>
	14	<dd>		16	</dt>
				17	<dd>
	15	Create a debugger object, and apply its <a href="Debugger		18	Create a debugger object, and apply its <a href="Debugger
	>	#addDebuggee" title="The Debugger object: addDebuggee"><code>addD		>	#addDebuggee" title="The Debugger object: addDebuggee"><code>addD
	>	ebuggee</code></a> method to each of the given <em>global</em> ob		>	ebuggee</code></a> method to each of the given <i>global</i> obje
	>	jects to add them as the initial debuggees.		>	cts to add them as the initial debuggees.
n	18	<h2 id="Accessor_Properties_of_the_Debugger_Prototype_Object"	n	21	<h2 id="accessor-properties-of-the-debugger-prototype-object"
	>	>		>	>
n			n	51	<code>allowWasmBinarySource</code>
				52	</dt>
				53	<dd>
				54	A boolean value indicating whether WebAssembly sources wi
				>	ll be available in binary form. The WebAssembly text generation w
				>	ill be disabled.
				55	</dd>
				56	<dt>
n	66	Either <code>null</code> or a function that SpiderMonke	n	75	Either <code>null</code> or a function that SpiderMonke
	>	y calls when a call to a debug event handler, breakpoint handler,		>	y calls when a call to a debug event handler, breakpoint handler,
	>	or similar function throws some exception, which we refer to as		>	or similar function throws some exception, which we refer to as
	>	<em>debugger-exception</em> here. Exceptions thrown in the debugg		>	<i>debugger-exception</i> here. Exceptions thrown in the debugger
	>	er are not propagated to debuggee code; instead, SpiderMonkey cal		>	are not propagated to debuggee code; instead, SpiderMonkey calls
	>	ls this function, passing <em>debugger-exception</em> as its sole		>	this function, passing <i>debugger-exception</i> as its sole arg
	>	argument and the <code>Debugger</code> instance as the <code>thi		>	ument and the <code>Debugger</code> instance as the <code>this</c
	>	s</code> value. This function should return a <a href="Convention		>	ode> value. This function should return a <a href="Conventions#re
	>	s#resumption-values" title="Debugger API: General Conventions: Re		>	sumption-values" title="Debugger API: General Conventions: Resump
	>	sumption Values">resumption value</a>, which determines how the d		>	tion Values">resumption value</a>, which determines how the debug
	>	ebuggee should continue.		>	gee should continue.
	67	</p>
	68	<p>		76	</p>
	69	If the uncaught exception hook itself throws an excepti
	>	on, <em>uncaught-hook-exception</em>, SpiderMonkey throws a new e
	>	rror object, <em>confess-to-debuggee-exception</em>, to the debug
	>	gee whose message blames the debugger, and includes textual descr
	>	iptions of<em>uncaught-hook-exception</em> and the original <em>d
	>	ebugger-exception</em>.
	70	</p>		77	<p>
				78	If the uncaught exception hook itself throws an excepti
				>	on, <i>uncaught-hook-exception</i>, SpiderMonkey throws a new err
				>	or object, <i>confess-to-debuggee-exception</i>, to the debuggee
				>	whose message blames the debugger, and includes textual descripti
				>	ons of <i>uncaught-hook-exception</i> and the original <i>debugge
				>	r-exception</i>.
	71	<p>		79	</p>
				80	<p>
	72	If <code>uncaughtExceptionHook</code>’s value is <code>		81	If <code>uncaughtExceptionHook</code>’s value is <code>
	>	null</code>, SpiderMonkey throws an exception to the debuggee who		>	null</code>, SpiderMonkey throws an exception to the debuggee who
	>	se message blames the debugger, and includes a textual descriptio		>	se message blames the debugger, and includes a textual descriptio
	>	n of <em>debugger-exception</em>.		>	n of <i>debugger-exception</i>.
n	82	<h2 id="Debugger_Handler_Functions">	n	91	<h2 id="debugger-handler-functions">
n	99	<code>onNewScript(<em>script</em>,<em>global</em>)</code>	n	108	<code>onNewScript(<i>script</i>, <i>global</i>)</code>
	100	</dt>
	101	<dd>		109	</dt>
	102	<p>		110	<dd>
				111	<p>
	103	New code, represented by the <a href="Debugger.Script"		112	New code, represented by the <a href="Debugger.Script"
	>	title="Debugger.Script"><code>Debugger.Script</code></a> instance		>	title="Debugger.Script"><code>Debugger.Script</code></a> instance
	>	<em>script</em>, has been loaded in the scope of the debuggees.		>	<i>script</i>, has been loaded in the scope of the debuggees.
n	110	<code>onNewPromise(<em>promise</em>)</code>	n	119	<code>onNewPromise(<i>promise</i>)</code>
n	117	This handler method should return a <a href="Convention	n	126	This handler method should return a <a href="Convention
	>	s#resumption-values" title="Debugger API: General Conventions: Re		>	s#resumption-values" title="Debugger API: General Conventions: Re
	>	sumption Values">resumption value</a> specifying how the debuggee		>	sumption Values">resumption value</a> specifying how the debuggee
	>	’s execution should proceed. However, note that a <code>{ return:		>	’s execution should proceed. However, note that a <code>{ return:
	>	<em>value</em> }</code> resumption value is treated like <code>un		>	<i>value</i> }</code> resumption value is treated like <code>und
	>	defined</code> (“continue normally”);<em>value</em> is ignored.		>	efined</code> (“continue normally”); <i>value</i> is ignored.
	118	</p>
	119	</dd>		127	</p>
	120	<dt>		128	</dd>
				129	<dt>
	121	<code>onPromiseSettled(<em>promise</em>)</code>		130	<code>onPromiseSettled(<i>promise</i>)</code>
n	128	This handler method should return a <a href="Convention	n	137	This handler method should return a <a href="Convention
	>	s#resumption-values" title="Debugger API: General Conventions: Re		>	s#resumption-values" title="Debugger API: General Conventions: Re
	>	sumption Values">resumption value</a> specifying how the debuggee		>	sumption Values">resumption value</a> specifying how the debuggee
	>	’s execution should proceed. However, note that a <code>{ return:		>	’s execution should proceed. However, note that a <code>{ return:
	>	<em>value</em> }</code> resumption value is treated like <code>un		>	<i>value</i> }</code> resumption value is treated like <code>und
	>	defined</code> (“continue normally”);<em>value</em> is ignored.		>	efined</code> (“continue normally”); <i>value</i> is ignored.
	129	</p>
	130	</dd>
	131	<dt>
	132	<code>onDebuggerStatement(<em>frame</em>)</code>
	133	</dt>
	134	<dd>
	135	Debuggee code has executed a <em>debugger</em> statement
	>	in <em>frame</em>. This method should return a <a href="Conventio
	>	ns#resumption-values" title="Debugger API: General Conventions: R
	>	esumption Values">resumption value</a> specifying how the debugge
	>	e’s execution should proceed.
	136	</dd>
	137	<dt>
	138	<code>onEnterFrame(<em>frame</em>)</code>
	139	</dt>
	140	<dd>
	141	<p>		138	</p>
				139	</dd>
				140	<dt>
				141	<code>onDebuggerStatement(<i>frame</i>)</code>
				142	</dt>
				143	<dd>
				144	Debuggee code has executed a <i>debugger</i> statement in
				>	<i>frame</i>. This method should return a <a href="Conventions#r
				>	esumption-values" title="Debugger API: General Conventions: Resum
				>	ption Values">resumption value</a> specifying how the debuggee’s
				>	execution should proceed.
				145	</dd>
				146	<dt>
				147	<code>onEnterFrame(<i>frame</i>)</code>
				148	</dt>
				149	<dd>
				150	<p>
	142	The stack frame <em>frame</em> is about to begin execut		151	The stack frame <i>frame</i> is about to begin executin
	>	ing code. (Naturally, <em>frame</em> is currently the youngest <a		>	g code. (Naturally, <i>frame</i> is currently the youngest <a hre
	>	href="Debugger.Frame#visible-frames" title="Debugger.Frame: Visi		>	f="Debugger.Frame#visible-frames" title="Debugger.Frame: Visible
	>	ble Frames">visible frame</a>.) This method should return a <a hr		>	Frames">visible frame</a>.) This method should return a <a href="
	>	ef="Conventions#resumption-values" title="Debugger API: General C		>	Conventions#resumption-values" title="Debugger API: General Conve
	>	onventions: Resumption Values">resumption value</a> specifying ho		>	ntions: Resumption Values">resumption value</a> specifying how th
	>	w the debuggee’s execution should proceed.		>	e debuggee’s execution should proceed.
n	149	<code>onExceptionUnwind(<em>frame</em>,<em>value</em>)</c	n	158	<code>onExceptionUnwind(<i>frame</i>, <i>value</i>)</code
	>	ode>		>	>
	150	</dt>
	151	<dd>		159	</dt>
	152	<p>		160	<dd>
				161	<p>
	153	The exception <em>value</em> has been thrown, and has p		162	The exception <i>value</i> has been thrown, and has pro
	>	ropagated to<em>frame</em>;<em>frame</em> is the youngest remaini		>	pagated to <i>frame</i>; <i>frame</i> is the youngest remaining s
	>	ng stack frame, and is a debuggee frame. This method should retur		>	tack frame, and is a debuggee frame. This method should return a
	>	n a <a href="Conventions#resumption-values" title="Debugger API:		>	<a href="Conventions#resumption-values" title="Debugger API: Gene
	>	General Conventions: Resumption Values">resumption value</a> spec		>	ral Conventions: Resumption Values">resumption value</a> specifyi
	>	ifying how the debuggee’s execution should proceed. If it returns		>	ng how the debuggee’s execution should proceed. If it returns <co
	>	<code>undefined</code>, the exception continues to propagate as		>	de>undefined</code>, the exception continues to propagate as norm
	>	normal: if control in <code>frame</code> is in a <code>try</code>		>	al: if control in <code>frame</code> is in a <code>try</code> blo
	>	block, control jumps to the corresponding <code>catch</code> or		>	ck, control jumps to the corresponding <code>catch</code> or <cod
	>	<code>finally</code> block; otherwise,<em>frame</em> is popped, a		>	e>finally</code> block; otherwise, <i>frame</i> is popped, and th
	>	nd the exception propagates to<em>frame</em>’s caller.		>	e exception propagates to <i>frame</i>’s caller.
n	163	<code>sourceHandler(<em>ASuffusionOfYellow</em>)</code>	n	172	<code>sourceHandler(<i>ASuffusionOfYellow</i>)</code>
n	169	<code>onError(<em>frame</em>,<em>report</em>)</code>	n	178	<code>onError(<i>frame</i>, <i>report</i>)</code>
	170	</dt>
	171	<dd>		179	</dt>
	172	<p>		180	<dd>
				181	<p>
	173	SpiderMonkey is about to report an error in <em>frame</		182	SpiderMonkey is about to report an error in <i>frame</i
	>	em>.<em>Report</em> is an object describing the error, with the f		>	>. <i>Report</i> is an object describing the error, with the foll
	>	ollowing properties:		>	owing properties:
n	186	If present, the source file name, URL, etc. (If this	n	195	If present, the source file name, URL, etc. (If this
	>	property is present, the<em>line</em> property will be too, and v		>	property is present, the <i>line</i> property will be too, and vi
	>	ice versa.)		>	ce versa.)
n	240	A new global object, <em>global</em>, has been created.	n	249	A new global object, <i>global</i>, has been created.
	241	</p>
	242	<p>		250	</p>
				251	<p>
	243	This handler method should return a <a href="Convention		252	This handler method should return a <a href="Convention
	>	s#resumption-values" title="Debugger API: General Conventions: Re		>	s#resumption-values" title="Debugger API: General Conventions: Re
	>	sumption Values">resumption value</a> specifying how the debuggee		>	sumption Values">resumption value</a> specifying how the debuggee
	>	’s execution should proceed. However, note that a <code>{ return:		>	’s execution should proceed. However, note that a <code>{ return:
	>	<em>value</em> }</code> resumption value is treated like <code>un		>	<i>value</i> }</code> resumption value is treated like <code>und
	>	defined</code> (“continue normally”);<em>value</em> is ignored. (		>	efined</code> (“continue normally”); <i>value</i> is ignored. (Al
	>	Allowing the handler to substitute its own value for the new glob		>	lowing the handler to substitute its own value for the new global
	>	al object doesn’t seem useful.)		>	object doesn’t seem useful.)
n	250	<h2 id="Function_Properties_of_the_Debugger_Prototype_Object"	n	259	<h2 id="function-properties-of-the-debugger-prototype-object"
	>	>		>	>
n	258	<code id="addDebuggee">addDebuggee(<em>global</em>)</code	n	267	<code id="addDebuggee">addDebuggee(<i>global</i>)</code>
	>	>
	259	</dt>
	260	<dd>		268	</dt>
	261	<p>		269	<dd>
	262	Add the global object designated by<em>global</em> to t
	>	he set of global objects this <code>Debugger</code> instance is d
	>	ebugging. If the designated global is already a debuggee, this ha
	>	s no effect. Return this <code>Debugger</code>’s <a href="Debugge
	>	r.Object" title="Debugger.Object"><code>Debugger.Object</code></a
	>	> instance referring to the designated global.
	263	</p>		270	<p>
				271	Add the global object designated by <i>global</i> to th
				>	e set of global objects this <code>Debugger</code> instance is de
				>	bugging. If the designated global is already a debuggee, this has
				>	no effect. Return this <code>Debugger</code>’s <a href="Debugger
				>	.Object" title="Debugger.Object"><code>Debugger.Object</code></a>
				>	instance referring to the designated global.
	264	<p>		272	</p>
				273	<p>
	265	The value<em>global</em> may be any of the following:		274	The value <i>global</i> may be any of the following:
n	290	Any other sort of value is treated as a <code>TypeE	n	299	Any other sort of value is treated as a <code>TypeE
	>	rror</code>. (Note that each rule is only applied once in the pro		>	rror</code>. (Note that each rule is only applied once in the pro
	>	cess of resolving a given<em>global</em> argument. Thus, for exam		>	cess of resolving a given <i>global</i> argument. Thus, for examp
	>	ple, a <a href="Debugger.Object" title="Debugger.Object"><code>De		>	le, a <a href="Debugger.Object" title="Debugger.Object"><code>Deb
	>	bugger.Object</code></a> referring to a second <a href="Debugger.		>	ugger.Object</code></a> referring to a second <a href="Debugger.O
	>	Object" title="Debugger.Object"><code>Debugger.Object</code></a>		>	bject" title="Debugger.Object"><code>Debugger.Object</code></a> w
	>	which refers to a global does not designate that global for the p		>	hich refers to a global does not designate that global for the pu
	>	urposes of this function.)		>	rposes of this function.)
n	295	The global designated by<em>global</em> must be in a di	n	304	The global designated by <i>global</i> must be in a dif
	>	fferent compartment than this <code>Debugger</code> instance itse		>	ferent compartment than this <code>Debugger</code> instance itsel
	>	lf. If adding the designated global’s compartment would create a		>	f. If adding the designated global’s compartment would create a c
	>	cycle of debugger and debuggee compartments, this method throws a		>	ycle of debugger and debuggee compartments, this method throws an
	>	n error.		>	error.
n	304	If this debugger is <a href="Debugger.Memory#trackingal	n	313	If this debugger is <a href="Debugger.Memory#trackingal
	>	locationsites" title="Debugger.Memory: trackingAllocationSites">t		>	locationsites" title="Debugger.Memory: trackingAllocationSites">t
	>	racking allocation sites</a> and cannot track allocation sites fo		>	racking allocation sites</a> and cannot track allocation sites fo
	>	r<em>global</em>, this method throws an <code>Error</code>.		>	r <i>global</i>, this method throws an <code>Error</code>.
n	322	<code>removeDebuggee(<em>global</em>)</code>	n	331	<code>removeDebuggee(<i>global</i>)</code>
	323	</dt>
	324	<dd>		332	</dt>
	325	<p>		333	<dd>
				334	<p>
	326	Remove the global object designated by<em>global</em> f		335	Remove the global object designated by <i>global</i> fr
	>	rom this <code>Debugger</code> instance’s set of debuggees. Retur		>	om this <code>Debugger</code> instance’s set of debuggees. Return
	>	n <code>undefined</code>.		>	<code>undefined</code>.
	327	</p>
	328	<p>		336	</p>
				337	<p>
	329	This method interprets<em>global</em> using the same ru		338	This method interprets <i>global</i> using the same rul
	>	les that <a href="Debugger#addDebuggee" title="The Debugger objec		>	es that <a href="Debugger#addDebuggee" title="The Debugger object
	>	t: addDebuggee"><code>addDebuggee</code></a> does.		>	: addDebuggee"><code>addDebuggee</code></a> does.
n	342	<code>hasDebuggee(<em>global</em>)</code>	n	351	<code>hasDebuggee(<i>global</i>)</code>
	343	</dt>
	344	<dd>		352	</dt>
	345	<p>		353	<dd>
				354	<p>
	346	Return <code>true</code> if the global object designate		355	Return <code>true</code> if the global object designate
	>	d by<em>global</em> is a debuggee of this <code>Debugger</code> i		>	d by <i>global</i> is a debuggee of this <code>Debugger</code> in
	>	nstance.		>	stance.
	347	</p>
	348	<p>		356	</p>
				357	<p>
	349	This method interprets<em>global</em> using the same ru		358	This method interprets <i>global</i> using the same rul
	>	les that <a href="Debugger#addDebuggee" title="The Debugger objec		>	es that <a href="Debugger#addDebuggee" title="The Debugger object
	>	t: addDebuggee"><code>addDebuggee</code></a> does.		>	: addDebuggee"><code>addDebuggee</code></a> does.
n	370	<code>findSources([<em>query</em>])<em>(not yet implement	n	379	<code>findSources([<i>query</i>]) <i>(not yet implemented
	>	ed)</em></code>		>	)</i></code>
	371	</dt>
	372	<dd>		380	</dt>
	373	<p>		381	<dd>
	374	Return an array of all <a href="Debugger.Source" title=
	>	"Debugger.Source"><code>Debugger.Source</code></a> instances matc
	>	hing<em>query</em>. Each source appears only once in the array.<e
	>	m>Query</em> is an object whose properties restrict which sources
	>	are returned; a source must meet all the criteria given by<em>qu
	>	ery</em> to be returned. If<em>query</em> is omitted, we return a
	>	ll sources of all debuggee scripts.
	375	</p>		382	<p>
				383	Return an array of all <a href="Debugger.Source" title=
				>	"Debugger.Source"><code>Debugger.Source</code></a> instances matc
				>	hing <i>query</i>. Each source appears only once in the array. <i
				>	>Query</i> is an object whose properties restrict which sources a
				>	re returned; a source must meet all the criteria given by <i>quer
				>	y</i> to be returned. If <i>query</i> is omitted, we return all s
				>	ources of all debuggee scripts.
	376	<p>		384	</p>
				385	<p>
	377	<em>Query</em>may have the following properties:		386	<i>Query</i> may have the following properties:
n	398	<code>findScripts([<em>query</em>])</code>	n	407	<code>findScripts([<i>query</i>])</code>
	399	</dt>
	400	<dd>		408	</dt>
	401	<p>		409	<dd>
	402	Return an array of <a href="Debugger.Script" title="Deb
	>	ugger.Script"><code>Debugger.Script</code></a> instances for all
	>	debuggee scripts matching<em>query</em>. Each instance appears on
	>	ly once in the array.<em>Query</em> is an object whose properties
	>	restrict which scripts are returned; a script must meet all the
	>	criteria given by<em>query</em> to be returned. If<em>query</em>
	>	is omitted, we return the <a href="Debugger.Script" title="Debugg
	>	er.Script"><code>Debugger.Script</code></a> instances for all deb
	>	uggee scripts.
	403	</p>		410	<p>
				411	Return an array of <a href="Debugger.Script" title="Deb
				>	ugger.Script"><code>Debugger.Script</code></a> instances for all
				>	debuggee scripts matching <i>query</i>. Each instance appears onl
				>	y once in the array. <i>Query</i> is an object whose properties r
				>	estrict which scripts are returned; a script must meet all the cr
				>	iteria given by <i>query</i> to be returned. If <i>query</i> is o
				>	mitted, we return the <a href="Debugger.Script" title="Debugger.S
				>	cript"><code>Debugger.Script</code></a> instances for all debugge
				>	e scripts.
	404	<p>		412	</p>
				413	<p>
	405	<em>Query</em>may have the following properties:		414	<i>Query</i> may have the following properties:
n	446	All properties of<em>query</em> are optional. Passing a	n	455	All properties of <i>query</i> are optional. Passing an
	>	n empty object returns all debuggee code scripts.		>	empty object returns all debuggee code scripts.
n	453	<code>findObjects([<em>query</em>])</code>	n	462	<code>findObjects([<i>query</i>])</code>
n	478	<code>clearBreakpoint(<em>handler</em>)</code>	n	487	<code>clearBreakpoint(<i>handler</i>)</code>
	479	</dt>
	480	<dd>		488	</dt>
				489	<dd>
	481	Remove all breakpoints set in this <code>Debugger</code>		490	Remove all breakpoints set in this <code>Debugger</code>
	>	instance that use<em>handler</em> as their handler. Note that, if		>	instance that use <i>handler</i> as their handler. Note that, if
	>	breakpoints using other handler objects are set at the same loca		>	breakpoints using other handler objects are set at the same locat
	>	tion(s) as<em>handler</em>, they remain in place.		>	ion(s) as <i>handler</i>, they remain in place.
n	504	<code>makeGlobalObjectReference(<em>global</em>)</code>	n	513	<code>makeGlobalObjectReference(<i>global</i>)</code>
	505	</dt>
	506	<dd>
	507	Return the <a href="Debugger.Object" title="Debugger.Obje
	>	ct"><code>Debugger.Object</code></a> whose referent is the global
	>	object designated by<em>global</em>, without adding the designat
	>	ed global as a debuggee. If<em>global</em> does not designate a g
	>	lobal object, throw a <code>TypeError</code>. Determine which glo
	>	bal is designated by<em>global</em> using the same rules as <a hr
	>	ef="Debugger#addDebuggee" title="The Debugger object: addDebuggee
	>	"><code>Debugger.prototype.addDebuggee</code></a>.
	508	</dd>
	509	<dt>		514	</dt>
				515	<dd>
				516	Return the <a href="Debugger.Object" title="Debugger.Obje
				>	ct"><code>Debugger.Object</code></a> whose referent is the global
				>	object designated by <i>global</i>, without adding the designate
				>	d global as a debuggee. If <i>global</i> does not designate a glo
				>	bal object, throw a <code>TypeError</code>. Determine which globa
				>	l is designated by <i>global</i> using the same rules as <a href=
				>	"Debugger#addDebuggee" title="The Debugger object: addDebuggee"><
				>	code>Debugger.prototype.addDebuggee</code></a>.
				517	</dd>
				518	<dt>
	510	<code>adoptDebuggeeValue(<em>value</em>)</code>		519	<code>adoptDebuggeeValue(<i>value</i>)</code>
n	521	<h2 id="Static_methods_of_the_Debugger_Object">	n	530	<h2 id="static-methods-of-the-debugger-object">
n	529	<code id="isCompilableUnit">isCompilableUnit(<em>source</	n	538	<code id="isCompilableUnit">isCompilableUnit(<i>source</i
	>	em>)</code>		>	>)</code>
	530	</dt>
	531	<dd>		539	</dt>
				540	<dd>
	532	Given a string of source code, designated by<em>source</e		541	Given a string of source code, designated by <i>source</i
	>	m>, return false if the string might become a valid JavaScript st		>	>, return false if the string might become a valid JavaScript sta
	>	atement with the addition of more lines. Otherwise return true. T		>	tement with the addition of more lines. Otherwise return true. Th
	>	he intent is to support interactive compilation - accumulate line		>	e intent is to support interactive compilation - accumulate lines
	>	s in a buffer until isCompilableUnit is true, then pass it to the		>	in a buffer until isCompilableUnit is true, then pass it to the
	>	compiler.		>	compiler.
n	535	<h4 id="Source_Metadata">	n	544	<h4>
n	542	<dt>	n
	543
	544	</dt>
n	551	<dd id="watermark">	n	557	<dd id='watermark'>
	552	sha256:308153d23de9cb0246347cfdbdf17d8ee5d0d8c5c984d52248		558	sha256:03b36132885e046a5f213130ba22b1139b473770f7324b8424
	>	1410a3af45be25		>	83c09ab7665f7c
t	558	<a href="https://hg.mozilla.org/mozilla-central/rev/7ae37	t	564	<a href="https://hg.mozilla.org/mozilla-central/rev/e91b2
	>	7917236">7ae377917236</a>		>	c85aacd">e91b2c85aacd</a>

Tools/Debugger-API/Debugger.Frame (en-US)

2017-07-28T14:45:20-07:00

Edited by:

jimblandy

<h3>Content changes:</h3>

	Revision 1181643			Revision 1278953
n			n	7	<h1 id="debugger.frame">
				8	Debugger.Frame
				9	</h1>
n	19	<h2 id="Visible_Frames">	n	22	<h2 id="visible-frames">
n	23	When inspecting the call stack, <a href="Debugger" title="T	n	26	When inspecting the call stack, <a href="Debugger" title="T
	>	he Debugger object"><code>Debugger</code></a> does not reveal all		>	he Debugger object"><code>Debugger</code></a> does not reveal all
	>	the frames that are actually present on the stack: while it does		>	the frames that are actually present on the stack: while it does
	>	reveal all frames running debuggee code, it omits frames running		>	reveal all frames running debuggee code, it omits frames running
	>	the debugger’s own code, and omits most frames running non-debug		>	the debugger’s own code, and omits most frames running non-debug
	>	gee code. We call those stack frames a <a href="Debugger" title="		>	gee code. We call those stack frames a <a href="Debugger" title="
	>	The Debugger object"><code>Debugger</code></a> does reveal <em>vi		>	The Debugger object"><code>Debugger</code></a> does reveal <i>vis
	>	sible frames</em>.		>	ible frames</i>.
n	51	<h2 id="Invocation_Functions_and_“debugger”_Frames">	n	54	<h2 id="invocation-functions-and-debugger-frames">
n	55	An<em>invocation function</em> is any function in this inte	n	58	An <i>invocation function</i> is any function in this inter
	>	rface that allows the debugger to invoke code in the debuggee: <c		>	face that allows the debugger to invoke code in the debuggee: <co
	>	ode>Debugger.Object.prototype.call</code>, <code>Debugger.Frame.p		>	de>Debugger.Object.prototype.call</code>, <code>Debugger.Frame.pr
	>	rototype.eval</code>, and so on.		>	ototype.eval</code>, and so on.
n	63	Let<em>older</em> be the youngest visible frame on the	n	66	Let <i>older</i> be the youngest visible frame on the s
	>	stack, or <code>null</code> if there is no such frame. (This is n		>	tack, or <code>null</code> if there is no such frame. (This is ne
	>	ever one of the the debugger’s own frames; those never appear as		>	ver one of the the debugger’s own frames; those never appear as <
	>	<code>Debugger.Frame</code> instances.)		>	code>Debugger.Frame</code> instances.)
	64	</p>
	65	</li>
	66	<li>
	67	<p>		67	</p>
				68	</li>
				69	<li>
				70	<p>
	68	Push a <code>"debugger"</code> frame on the stack, with		71	Push a <code>"debugger"</code> frame on the stack, with
	>	<em>older</em> as its <code>older</code> property.		>	<i>older</i> as its <code>older</code> property.
n	85	<h2 id="Accessor_Properties_of_the_Debugger.Frame_Prototype_O	n	88	<h2 id="accessor-properties-of-the-debugger.frame-prototype-o
	>	bject">		>	bject">
n			n	125	<code>"wasmcall"</code>: a frame running a WebAssem
				>	bly function call.
				126	</p>
				127	</li>
				128	<li>
				129	<p>
n			n	158	<li>
				159	<p>
				160	<code>"wasm"</code>: a frame running in WebAssembly
				>	baseline JIT.
				161	</p>
				162	</li>
n	156	The value of <code>this</code> for this frame (a debuggee	n	169	The value of <code>this</code> for this frame (a debuggee
	>	value).		>	value). For a <code>wasmcall</code> frame, this property throws
				>	a <code>TypeError</code>.
n	186	The offset of the bytecode instruction currently being ex	n	199	The offset of the bytecode instruction currently being ex
	>	ecuted in <code>script</code>, or <code>undefined</code> if the f		>	ecuted in <code>script</code>, or <code>undefined</code> if the f
	>	rame’s <code>script</code> property is <code>null</code>.		>	rame’s <code>script</code> property is <code>null</code>. For a <
				>	code>wasmcall</code> frame, this property throws a <code>TypeErro
				>	r</code>.
n	219	<h2 id="Handler_Methods_of_Debugger.Frame_Instances">	n	232	<h2 id="handler-methods-of-debugger.frame-instances">
n	276	<h2 id="Function_Properties_of_the_Debugger.Frame_Prototype_O	n	289	<h2 id="function-properties-of-the-debugger.frame-prototype-o
	>	bject">		>	bject">
n	284	<code id="eval">eval(<em>code</em>, [<em>options</em>])</	n	297	<code id="eval">eval(<i>code</i>, [<i>options</i>])</code
	>	code>		>	>
	285	</dt>
	286	<dd>		298	</dt>
	287	<p>		299	<dd>
	288	Evaluate <em>code</em> in the execution context of this
	>	frame, and return a <a href="Conventions#completion-values" titl
	>	e="Debugger API: General Conventions: Completion Values">completi
	>	on value</a> describing how it completed. <em>Code</em> is a stri
	>	ng. If this frame’s <code>environment</code> property is <code>nu
	>	ll</code>, throw a <code>TypeError</code>. All extant handler met
	>	hods, breakpoints, and so on remain active during the call. This
	>	function follows the <a href="Debugger.Frame#invf" title="Debugge
	>	r.Frame: Invocation Frames">invocation function conventions</a>.
	289	</p>		300	<p>
				301	Evaluate <i>code</i> in the execution context of this f
				>	rame, and return a <a href="Conventions#completion-values" title=
				>	"Debugger API: General Conventions: Completion Values">completion
				>	value</a> describing how it completed. <i>Code</i> is a string.
				>	If this frame’s <code>environment</code> property is <code>null</
				>	code> or <code>type</code> property is <code>wasmcall</code>, thr
				>	ow a <code>TypeError</code>. All extant handler methods, breakpoi
				>	nts, and so on remain active during the call. This function follo
				>	ws the <a href="Debugger.Frame#invf" title="Debugger.Frame: Invoc
				>	ation Frames">invocation function conventions</a>.
	290	<p>		302	</p>
				303	<p>
	291	<em>Code</em> is interpreted as strict mode code when i		304	<i>Code</i> is interpreted as strict mode code when it
	>	t contains a Use Strict Directive, or the code executing in this		>	contains a Use Strict Directive, or the code executing in this fr
	>	frame is strict mode code.		>	ame is strict mode code.
	292	</p>
	293	<p>		305	</p>
	294	If <em>code</em> is not strict mode code, then variable
	>	declarations in <em>code</em> affect the environment of this fra
	>	me. (In the terms used by the ECMAScript specification, the <code
	>	>VariableEnvironment</code> of the execution context for the eval
	>	code is the <code>VariableEnvironment</code> of the execution co
	>	ntext that this frame represents.) If implementation restrictions
	>	prevent SpiderMonkey from extending this frame’s environment as
	>	requested, this call throws an Error exception.
	295	</p>		306	<p>
				307	If <i>code</i> is not strict mode code, then variable d
				>	eclarations in <i>code</i> affect the environment of this frame.
				>	(In the terms used by the ECMAScript specification, the <code>Var
				>	iableEnvironment</code> of the execution context for the eval cod
				>	e is the <code>VariableEnvironment</code> of the execution contex
				>	t that this frame represents.) If implementation restrictions pre
				>	vent SpiderMonkey from extending this frame’s environment as requ
				>	ested, this call throws an Error exception.
	296	<p>		308	</p>
				309	<p>
	297	If given, <em>options</em> should be an object whose pr		310	If given, <i>options</i> should be an object whose prop
	>	operties specify details of how the evaluation should occur. The		>	erties specify details of how the evaluation should occur. The <c
	>	<code>eval</code> method recognizes the following properties:		>	ode>eval</code> method recognizes the following properties:
n	304	The filename or URL to which we should attribute <em>	n	317	The filename or URL to which we should attribute <i>c
	>	code</em>. If this property is omitted, the URL defaults to <code		>	ode</i>. If this property is omitted, the URL defaults to <code>"
	>	>"debugger eval code"</code>.		>	debugger eval code"</code>.
n	310	The line number at which the evaluated code should be	n	323	The line number at which the evaluated code should be
	>	claimed to begin within <em>url</em>.		>	claimed to begin within <i>url</i>.
n	315	<code>evalWithBindings(<em>code</em>,<em>bindings</em>, [	n	328	<code>evalWithBindings(<i>code</i>, <i>bindings</i>, [<i>
	>	<em>options</em>])</code>		>	options</i>])</code>
	316	</dt>
	317	<dd>		329	</dt>
	318	<p>		330	<dd>
	319	Like <code>eval</code>, but evaluate <em>code</em> in t		331	<p>
	>	he environment of this frame, extended with bindings from the obj
	>	ect <em>bindings</em>. For each own enumerable property of <em>bi
	>	ndings</em> named <em>name</em> whose value is <em>value</em>, in
	>	clude a variable in the environment in which<em>code</em> is eval
	>	uated named <em>name</em>, whose value is<em>value</em>. Each <em
	>	>value</em> must be a debuggee value. (This is not like a <code>w
	>	ith</code> statement: <em>code</em> may access, assign to, and de
	>	lete the introduced bindings without having any effect on the <em
	>	>bindings</em> object.)
				332	Like <code>eval</code>, but evaluate <i>code</i> in the
				>	environment of this frame, extended with bindings from the objec
				>	t <i>bindings</i>. For each own enumerable property of <i>binding
				>	s</i> named <i>name</i> whose value is <i>value</i>, include a va
				>	riable in the environment in which <i>code</i> is evaluated named
				>	<i>name</i>, whose value is <i>value</i>. Each <i>value</i> must
				>	be a debuggee value. (This is not like a <code>with</code> state
				>	ment: <i>code</i> may access, assign to, and delete the introduce
				>	d bindings without having any effect on the <i>bindings</i> objec
				>	t.)
n	325	Note that, like <code>eval</code>, declarations in the<	n	338	Note that, like <code>eval</code>, declarations in the
	>	em>code</em> passed to <code>evalWithBindings</code> affect the e		>	<i>code</i> passed to <code>evalWithBindings</code> affect the en
	>	nvironment of this frame, even as that environment is extended by		>	vironment of this frame, even as that environment is extended by
	>	bindings visible within <em>code</em>. (In the terms used by the		>	bindings visible within <i>code</i>. (In the terms used by the EC
	>	ECMAScript specification, the <code>VariableEnvironment</code> o		>	MAScript specification, the <code>VariableEnvironment</code> of t
	>	f the execution context for the eval code is the <code>VariableEn		>	he execution context for the eval code is the <code>VariableEnvir
	>	vironment</code> of the execution context that this frame represe		>	onment</code> of the execution context that this frame represents
	>	nts, and the <em>bindings</em> appear in a new declarative enviro		>	, and the <i>bindings</i> appear in a new declarative environment
	>	nment, which is the eval code’s <code>LexicalEnvironment</code>.)		>	, which is the eval code’s <code>LexicalEnvironment</code>.) If i
	>	If implementation restrictions prevent SpiderMonkey from extendi		>	mplementation restrictions prevent SpiderMonkey from extending th
	>	ng this frame’s environment as requested, this call throws an <co		>	is frame’s environment as requested, this call throws an <code>Er
	>	de>Error</code> exception.		>	ror</code> exception.
	326	</p>
	327	<p>		339	</p>
	328	The <em>options</em> argument is as for <a href="Debugg		340	<p>
	>	er.Frame#eval" title="Debugger.Frame: Eval"><code>Debugger.Frame.
	>	prototype.eval</code></a>, described above.
				341	The <i>options</i> argument is as for <a href="Debugger
				>	.Frame#eval" title="Debugger.Frame: Eval"><code>Debugger.Frame.pr
				>	ototype.eval</code></a>, described above. Also like <code>eval</c
				>	ode>, if this frame’s <code>environment</code> property is <code>
				>	null</code> or <code>type</code> property is <code>wasmcall</code
				>	>, throw a <code>TypeError</code>.
n	332	<h4 id="Source_Metadata">	n	345	<h4>
n	339	<dt>	n
	340
	341	</dt>
n	348	<dd id="watermark">	n	358	<dd id='watermark'>
	349	sha256:e4d6d8e94b7d4bd35cf16724daa6e1a31acbcd35ff25b3ee4c		359	sha256:b1894f88b76b7afd661f3044a05690d76d1498c54c596ca729
	>	de44db3fb203df		>	c6ee0d150d2da1
t	355	<a href="https://hg.mozilla.org/mozilla-central/rev/7ae37	t	365	<a href="https://hg.mozilla.org/mozilla-central/rev/e91b2
	>	7917236">7ae377917236</a>		>	c85aacd">e91b2c85aacd</a>

Tools/Debugger-API/Debugger.Object (en-US)

2017-07-28T14:45:22-07:00

Edited by:

jimblandy

<h3>Content changes:</h3>

	Revision 1129317			Revision 1278955
n			n	7	<h1 id="debugger.object">
				8	Debugger.Object
				9	</h1>
n	25	<h2 id="Accessor_Properties_of_the_Debugger.Object_prototype"	n	28	<h2 id="accessor-properties-of-the-debugger.object-prototype"
	>	>		>	>
n	83	Note that the display name may not be a proper JavaScri	n	86	Note that the display name may not be a proper JavaScri
	>	pt identifier, or even a proper expression: we attempt to find he		>	pt identifier, or even a proper expression: we attempt to find he
	>	lpful names even when the function is not immediately assigned as		>	lpful names even when the function is not immediately assigned as
	>	the value of some variable or property. Thus, we use <code><em>a		>	the value of some variable or property. Thus, we use <code><i>a<
	>	</em>/<em>b</em></code> to refer to the<em>b</em> defined within<		>	/i>/<i>b</i></code> to refer to the <i>b</i> defined within <i>a<
	>	em>a</em>, and <code><em>a</em><</code> to refer to a function		>	/i>, and <code><i>a</i><</code> to refer to a function that oc
	>	that occurs somewhere within an expression that is assigned to<e		>	curs somewhere within an expression that is assigned to <i>a</i>.
	>	m>a</em>. For example:		>	For example:
n			n	141	<code>errorLineNumber</code>
				142	</dt>
				143	<dd>
				144	If the referent is an Error object, this is the line numb
				>	er at which the referent was created; <code>undefined</code> othe
				>	rwise.
				145	</dd>
				146	<dt>
				147	<code>errorColumnNumber</code>
				148	</dt>
				149	<dd>
				150	If the referent is an Error object, this is the column nu
				>	mber at which the referent was created; <code>undefined</code> ot
				>	herwise.
				151	</dd>
				152	<dt>
n			n	163	</dd>
				164	<dt>
				165	<code>isGeneratorFunction</code>
				166	</dt>
				167	<dd>
				168	If the referent is a debuggee function, returns <code>tru
				>	e</code> if the referent was created with a <code>function*</code
				>	> expression or statement, or false if it is some other sort of f
				>	unction. If the referent is not a debuggee function, or not a fun
				>	ction at all, this is <code>undefined</code>. (This is always equ
				>	al to <code>obj.script.isGeneratorFunction</code>, assuming <code
				>	>obj.script</code> is a <code>Debugger.Script</code>.)
				169	</dd>
				170	<dt>
				171	<code>isAsyncFunction</code>
				172	</dt>
				173	<dd>
				174	If the referent is a debuggee function, returns <code>tru
				>	e</code> if the referent is an async function, defined with an <c
				>	ode>async function</code> expression or statement, or false if it
				>	is some other sort of function. If the referent is not a debugge
				>	e function, or not a function at all, this is <code>undefined</co
				>	de>. (This is always equal to <code>obj.script.isAsyncFunction</c
				>	ode>, assuming <code>obj.script</code> is a <code>Debugger.Script
				>	</code>.)
n	309	<h2 id="Function_Properties_of_the_Debugger.Object_prototype"	n	336	<h2 id="function-properties-of-the-debugger.object-prototype"
	>	>		>	>
n	320	<code>getProperty(<em>name</em>)</code>	n	347	<code>getProperty(<i>name</i>)</code>
	321	</dt>
	322	<dd>		348	</dt>
				349	<dd>
	323	Return the value of the referent’s property named<em>name		350	Return the value of the referent’s property named <i>name
	>	</em>, or <code>undefined</code> if it has no such property.<em>N		>	</i>, or <code>undefined</code> if it has no such property. <i>Na
	>	ame</em> must be a string. The result is a debuggee value.		>	me</i> must be a string. The result is a debuggee value.
	324	</dd>
	325	<dt>
	326	<code>setProperty(<em>name</em>,<em>value</em>)</code>
	327	</dt>
	328	<dd>		351	</dd>
	329	Store<em>value</em> as the value of the referent’s proper
	>	ty named<em>name</em>, creating the property if it does not exist
	>	.<em>Name</em> must be a string;<em>value</em> must be a debuggee
	>	value.
	330	</dd>
	331	<dt>
	332	<code>getOwnPropertyDescriptor(<em>name</em>)</code>
	333	</dt>		352	<dt>
				353	<code>setProperty(<i>name</i>, <i>value</i>)</code>
				354	</dt>
				355	<dd>
				356	Store <i>value</i> as the value of the referent’s propert
				>	y named <i>name</i>, creating the property if it does not exist.
				>	<i>Name</i> must be a string; <i>value</i> must be a debuggee val
				>	ue.
	334	<dd>		357	</dd>
				358	<dt>
				359	<code>getOwnPropertyDescriptor(<i>name</i>)</code>
				360	</dt>
				361	<dd>
	335	Return a property descriptor for the property named<em>na		362	Return a property descriptor for the property named <i>na
	>	me</em> of the referent. If the referent has no such property, re		>	me</i> of the referent. If the referent has no such property, ret
	>	turn <code>undefined</code>. (This function behaves like the stan		>	urn <code>undefined</code>. (This function behaves like the stand
	>	dard <code>Object.getOwnPropertyDescriptor</code> function, excep		>	ard <code>Object.getOwnPropertyDescriptor</code> function, except
	>	t that the object being inspected is implicit; the property descr		>	that the object being inspected is implicit; the property descri
	>	iptor returned is allocated as if by code scoped to the debugger’		>	ptor returned is allocated as if by code scoped to the debugger’s
	>	s global object (and is thus in the debugger’s compartment); and		>	global object (and is thus in the debugger’s compartment); and i
	>	its <code>value</code>, <code>get</code>, and <code>set</code> pr		>	ts <code>value</code>, <code>get</code>, and <code>set</code> pro
	>	operties, if present, are debuggee values.)		>	perties, if present, are debuggee values.)
n	341	Return an array of strings naming all the referent’s own	n	368	Return an array of strings naming all the referent’s own
	>	properties, as if <code>Object.getOwnPropertyNames(<em>referent</		>	properties, as if <code>Object.getOwnPropertyNames(<i>referent</i
	>	em>)</code> had been called in the debuggee, and the result copie		>	>)</code> had been called in the debuggee, and the result copied
	>	d in the scope of the debugger’s global object.		>	in the scope of the debugger’s global object.
n	347	Return an array of strings naming all the referent’s own	n	374	Return an array of strings naming all the referent’s own
	>	symbols, as if <code>Object.getOwnPropertySymbols(<em>referent</e		>	symbols, as if <code>Object.getOwnPropertySymbols(<i>referent</i>
	>	m>)</code> had been called in the debuggee, and the result copied		>	)</code> had been called in the debuggee, and the result copied i
	>	in the scope of the debugger’s global object.		>	n the scope of the debugger’s global object.
	348	</dd>
	349	<dt>
	350	<code>defineProperty(<em>name</em>,<em>attributes</em>)</
	>	code>
	351	</dt>
	352	<dd>		375	</dd>
	353	Define a property on the referent named<em>name</em>, as
	>	described by the property descriptor<em>descriptor</em>. Any <cod
	>	e>value</code>, <code>get</code>, and <code>set</code> properties
	>	of<em>attributes</em> must be debuggee values. (This function be
	>	haves like <code>Object.defineProperty</code>, except that the ta
	>	rget object is implicit, and in a different compartment from the
	>	function and descriptor.)
	354	</dd>
	355	<dt>
	356	<code>defineProperties(<em>properties</em>)</code>
	357	</dt>		376	<dt>
	358	<dd>		377	<code>defineProperty(<i>name</i>, <i>attributes</i>)</cod
				>	e>
	359	Add the properties given by<em>properties</em> to the ref
	>	erent. (This function behaves like <code>Object.defineProperties<
	>	/code>, except that the target object is implicit, and in a diffe
	>	rent compartment from the<em>properties</em> argument.)
	360	</dd>
	361	<dt>		378	</dt>
	362	<code>deleteProperty(<em>name</em>)</code>
	363	</dt>		379	<dd>
				380	Define a property on the referent named <i>name</i>, as d
				>	escribed by the property descriptor <i>descriptor</i>. Any <code>
				>	value</code>, <code>get</code>, and <code>set</code> properties o
				>	f <i>attributes</i> must be debuggee values. (This function behav
				>	es like <code>Object.defineProperty</code>, except that the targe
				>	t object is implicit, and in a different compartment from the fun
				>	ction and descriptor.)
	364	<dd>		381	</dd>
				382	<dt>
				383	<code>defineProperties(<i>properties</i>)</code>
				384	</dt>
				385	<dd>
				386	Add the properties given by <i>properties</i> to the refe
				>	rent. (This function behaves like <code>Object.defineProperties</
				>	code>, except that the target object is implicit, and in a differ
				>	ent compartment from the <i>properties</i> argument.)
				387	</dd>
				388	<dt>
				389	<code>deleteProperty(<i>name</i>)</code>
				390	</dt>
				391	<dd>
	365	Remove the referent’s property named<em>name</em>. Return		392	Remove the referent’s property named <i>name</i>. Return
	>	true if the property was successfully removed, or if the referen		>	true if the property was successfully removed, or if the referent
	>	t has no such property. Return false if the property is non-confi		>	has no such property. Return false if the property is non-config
	>	gurable.		>	urable.
n	404	<code>copy(<em>value</em>)</code>	n	431	<code>copy(<i>value</i>)</code>
	405	</dt>
	406	<dd>		432	</dt>
	407	<p>		433	<dd>
				434	<p>
	408	Apply the HTML5 “structured cloning” algorithm to creat		435	Apply the HTML5 “structured cloning” algorithm to creat
	>	e a copy of<em>value</em> in the referent’s global object (and th		>	e a copy of <i>value</i> in the referent’s global object (and thu
	>	us in the referent’s compartment), and return a <code>Debugger.Ob		>	s in the referent’s compartment), and return a <code>Debugger.Obj
	>	ject</code> instance referring to the copy.		>	ect</code> instance referring to the copy.
n	415	<code>create(<em>prototype</em>, [<em>properties</em>])</	n	442	<code>create(<i>prototype</i>, [<i>properties</i>])</code
	>	code>		>	>
	416	</dt>
	417	<dd>
	418	Create a new object in the referent’s global (and thus in
	>	the referent’s compartment), and return a <code>Debugger.Object<
	>	/code> referring to it. The new object’s prototype is<em>prototyp
	>	e</em>, which must be an <code>Debugger.Object</code> instance. T
	>	he new object’s properties are as given by<em>properties</em>, as
	>	if<em>properties</em> were passed to <code>Debugger.Object.proto
	>	type.defineProperties</code>, with the new <code>Debugger.Object<
	>	/code> instance as the <code>this</code> value.
	419	</dd>
	420	<dt>		443	</dt>
	421	<code>makeDebuggeeValue(<em>value</em>)</code>
	422	</dt>		444	<dd>
				445	Create a new object in the referent’s global (and thus in
				>	the referent’s compartment), and return a <code>Debugger.Object<
				>	/code> referring to it. The new object’s prototype is <i>prototyp
				>	e</i>, which must be an <code>Debugger.Object</code> instance. Th
				>	e new object’s properties are as given by <i>properties</i>, as i
				>	f <i>properties</i> were passed to <code>Debugger.Object.prototyp
				>	e.defineProperties</code>, with the new <code>Debugger.Object</co
				>	de> instance as the <code>this</code> value.
	423	<dd>		446	</dd>
	424	<p>		447	<dt>
	425	Return the debuggee value that represents<em>value</em>		448	<code>makeDebuggeeValue(<i>value</i>)</code>
	>	in the debuggee. If<em>value</em> is a primitive, we return it u
	>	nchanged; if<em>value</em> is an object, we return the <code>Debu
	>	gger.Object</code> instance representing that object, wrapped app
	>	ropriately for use in this <code>Debugger.Object</code>’s referen
	>	t’s compartment.
				449	</dt>
				450	<dd>
	426	</p>		451	<p>
				452	Return the debuggee value that represents <i>value</i>
				>	in the debuggee. If <i>value</i> is a primitive, we return it unc
				>	hanged; if <i>value</i> is an object, we return the <code>Debugge
				>	r.Object</code> instance representing that object, wrapped approp
				>	riately for use in this <code>Debugger.Object</code>’s referent’s
				>	compartment.
	427	<p>		453	</p>
				454	<p>
	428	Note that, if<em>value</em> is an object, it need not b		455	Note that, if <i>value</i> is an object, it need not be
	>	e one allocated in a debuggee global, nor even a debuggee compart		>	one allocated in a debuggee global, nor even a debuggee compartm
	>	ment; it can be any object the debugger wishes to use as a debugg		>	ent; it can be any object the debugger wishes to use as a debugge
	>	ee value.		>	e value.
	429	</p>
	430	<p>		456	</p>
	431	As described above, each <code>Debugger.Object</code> i
	>	nstance presents its referent as viewed from a particular compart
	>	ment. Given a <code>Debugger.Object</code> instance<em>d</em> and
	>	an object<em>o</em>, the call <code><em>d</em>.makeDebuggeeValue
	>	(<em>o</em>)</code> returns a <code>Debugger.Object</code> instan
	>	ce that presents<em>o</em> as it would be seen by code in<em>d</e
	>	m>’s compartment.
	432	</p>		457	<p>
				458	As described above, each <code>Debugger.Object</code> i
				>	nstance presents its referent as viewed from a particular compart
				>	ment. Given a <code>Debugger.Object</code> instance <i>d</i> and
				>	an object <i>o</i>, the call <code><i>d</i>.makeDebuggeeValue(<i>
				>	o</i>)</code> returns a <code>Debugger.Object</code> instance tha
				>	t presents <i>o</i> as it would be seen by code in <i>d</i>’s com
				>	partment.
	433	</dd>		459	</p>
	434	<dt>
	435	<code>decompile([<em>pretty</em>])</code>
	436	</dt>
	437	<dd>		460	</dd>
				461	<dt>
				462	<code>decompile([<i>pretty</i>])</code>
				463	</dt>
				464	<dd>
	438	If the referent is a function that is debuggee code, retu		465	If the referent is a function that is debuggee code, retu
	>	rn the JavaScript source code for a function definition equivalen		>	rn the JavaScript source code for a function definition equivalen
	>	t to the referent function in its effect and result, as a string.		>	t to the referent function in its effect and result, as a string.
	>	If<em>pretty</em> is present and true, produce indented code wit		>	If <i>pretty</i> is present and true, produce indented code with
	>	h line breaks. If the referent is not a function that is debuggee		>	line breaks. If the referent is not a function that is debuggee
	>	code, return <code>undefined</code>.		>	code, return <code>undefined</code>.
	439	</dd>
	440	<dt>
	441	<code>call(<em>this</em>,<em>argument</em>, …)</code>
	442	</dt>
	443	<dd>		466	</dd>
	444	If the referent is callable, call it with the given<em>th
	>	is</em> value and<em>argument</em> values, and return a <a href="
	>	Conventions#completion-values" title="Debugger API: General Conve
	>	ntions: Completion Values">completion value</a> describing how th
	>	e call completed.<em>This</em> should be a debuggee value, or <co
	>	de>{ asConstructor: true }</code> to invoke the referent as a con
	>	structor, in which case SpiderMonkey provides an appropriate <cod
	>	e>this</code> value itself. Each<em>argument</em> must be a debug
	>	gee value. All extant handler methods, breakpoints, and so on rem
	>	ain active during the call. If the referent is not callable, thro
	>	w a <code>TypeError</code>. This function follows the <a href="De
	>	bugger.Frame#invf" title="Debugger.Frame: Invocation Frames">invo
	>	cation function conventions</a>.
	445	</dd>
	446	<dt>
	447	<code>apply(<em>this</em>,<em>arguments</em>)</code>
	448	</dt>		467	<dt>
	449	<dd>		468	<code>call(<i>this</i>, <i>argument</i>, …)</code>
	450	If the referent is callable, call it with the given<em>th
	>	is</em> value and the argument values in<em>arguments</em>, and r
	>	eturn a <a href="Conventions#completion-values" title="Debugger A
	>	PI: General Conventions: Completion Values">completion value</a>
	>	describing how the call completed.<em>This</em> should be a debug
	>	gee value, or <code>{ asConstructor: true }</code> to invoke<em>f
	>	unction</em> as a constructor, in which case SpiderMonkey provide
	>	s an appropriate <code>this</code> value itself.<em>Arguments</em
	>	> must either be an array (in the debugger) of debuggee values, o
	>	r <code>null</code> or <code>undefined</code>, which are treated
	>	as an empty array. All extant handler methods, breakpoints, and s
	>	o on remain active during the call. If the referent is not callab
	>	le, throw a <code>TypeError</code>. This function follows the <a
	>	href="Debugger.Frame#invf" title="Debugger.Frame: Invocation Fram
	>	es">invocation function conventions</a>.
	451	</dd>
	452	<dt>		469	</dt>
	453	<code>executeInGlobal(<em>code</em>, [<em>options</em>])<
	>	/code>
	454	</dt>		470	<dd>
				471	If the referent is callable, call it with the given <i>th
				>	is</i> value and <i>argument</i> values, and return a <a href="Co
				>	nventions#completion-values" title="Debugger API: General Convent
				>	ions: Completion Values">completion value</a> describing how the
				>	call completed. <i>This</i> should be a debuggee value, or <code>
				>	{ asConstructor: true }</code> to invoke the referent as a constr
				>	uctor, in which case SpiderMonkey provides an appropriate <code>t
				>	his</code> value itself. Each <i>argument</i> must be a debuggee
				>	value. All extant handler methods, breakpoints, and so on remain
				>	active during the call. If the referent is not callable, throw a
				>	<code>TypeError</code>. This function follows the <a href="Debugg
				>	er.Frame#invf" title="Debugger.Frame: Invocation Frames">invocati
				>	on function conventions</a>.
	455	<dd>		472	</dd>
	456	<p>		473	<dt>
	457	If the referent is a global object, evaluate<em>code</e		474	<code>apply(<i>this</i>, <i>arguments</i>)</code>
	>	m> in that global environment, and return a <a href="Conventions#
	>	completion-values" title="Debugger API: General Conventions: Comp
	>	letion Values">completion value</a> describing how it completed.<
	>	em>Code</em> is a string. All extant handler methods, breakpoints
	>	, and so on remain active during the call. This function follows
	>	the <a href="Debugger.Frame#invf" title="Debugger.Frame: Invocati
	>	on Frames">invocation function conventions</a>. If the referent i
	>	s not a global object, throw a <code>TypeError</code> exception.
				475	</dt>
				476	<dd>
				477	If the referent is callable, call it with the given <i>th
				>	is</i> value and the argument values in <i>arguments</i>, and ret
				>	urn a <a href="Conventions#completion-values" title="Debugger API
				>	: General Conventions: Completion Values">completion value</a> de
				>	scribing how the call completed. <i>This</i> should be a debuggee
				>	value, or <code>{ asConstructor: true }</code> to invoke <i>func
				>	tion</i> as a constructor, in which case SpiderMonkey provides an
				>	appropriate <code>this</code> value itself. <i>Arguments</i> mus
				>	t either be an array (in the debugger) of debuggee values, or <co
				>	de>null</code> or <code>undefined</code>, which are treated as an
				>	empty array. All extant handler methods, breakpoints, and so on
				>	remain active during the call. If the referent is not callable, t
				>	hrow a <code>TypeError</code>. This function follows the <a href=
				>	"Debugger.Frame#invf" title="Debugger.Frame: Invocation Frames">i
				>	nvocation function conventions</a>.
				478	</dd>
				479	<dt>
				480	<code>executeInGlobal(<i>code</i>, [<i>options</i>])</cod
				>	e>
				481	</dt>
				482	<dd>
	458	</p>		483	<p>
				484	If the referent is a global object, evaluate <i>code</i
				>	> in that global environment, and return a <a href="Conventions#c
				>	ompletion-values" title="Debugger API: General Conventions: Compl
				>	etion Values">completion value</a> describing how it completed. <
				>	i>Code</i> is a string. All extant handler methods, breakpoints,
				>	and so on remain active during the call. This function follows th
				>	e <a href="Debugger.Frame#invf" title="Debugger.Frame: Invocation
				>	Frames">invocation function conventions</a>. If the referent is
				>	not a global object, throw a <code>TypeError</code> exception.
	459	<p>		485	</p>
				486	<p>
	460	<em>Code</em>is interpreted as strict mode code when it		487	<i>Code</i> is interpreted as strict mode code when it
	>	contains a Use Strict Directive.		>	contains a Use Strict Directive.
	461	</p>
	462	<p>		488	</p>
	463	This evaluation is semantically equivalent to executing
	>	statements at the global level, not an indirect eval. Regardless
	>	of<em>code</em> being strict mode code, variable declarations in
	>	<em>code</em> affect the referent global object.
	464	</p>		489	<p>
				490	This evaluation is semantically equivalent to executing
				>	statements at the global level, not an indirect eval. Regardless
				>	of <i>code</i> being strict mode code, variable declarations in
				>	<i>code</i> affect the referent global object.
	465	<p>		491	</p>
				492	<p>
	466	The<em>options</em> argument is as for <a href="Debugge		493	The <i>options</i> argument is as for <a href="Debugger
	>	r.Frame#eval" title="Debugger.Frame: Eval"><code>Debugger.Frame.p		>	.Frame#eval" title="Debugger.Frame: Eval"><code>Debugger.Frame.pr
	>	rototype.eval</code></a>.		>	ototype.eval</code></a>.
	467	</p>
	468	</dd>
	469	<dt>
	470	<code>executeInGlobalWithBindings(<em>code</em>,<em>bindi
	>	ngs</em>, [<em>options</em>])</code>
	471	</dt>
	472	<dd>
	473	<p>		494	</p>
	474	Like <code>executeInGlobal</code>, but evaluate<em>code		495	</dd>
	>	</em> using the referent as the variable object, but with a lexic
	>	al environment extended with bindings from the object<em>bindings
	>	</em>. For each own enumerable property of<em>bindings</em> named
	>	<em>name</em> whose value is<em>value</em>, include a variable in
	>	the lexical environment in which<em>code</em> is evaluated named
	>	<em>name</em>, whose value is<em>value</em>. Each<em>value</em> m
	>	ust be a debuggee value. (This is not like a <code>with</code> st
	>	atement:<em>code</em> may access, assign to, and delete the intro
	>	duced bindings without having any effect on the<em>bindings</em>
	>	object.)
				496	<dt>
				497	<code>executeInGlobalWithBindings(<i>code</i>, <i>binding
				>	s</i>, [<i>options</i>])</code>
				498	</dt>
				499	<dd>
				500	<p>
				501	Like <code>executeInGlobal</code>, but evaluate <i>code
				>	</i> using the referent as the variable object, but with a lexica
				>	l environment extended with bindings from the object <i>bindings<
				>	/i>. For each own enumerable property of <i>bindings</i> named <i
				>	>name</i> whose value is <i>value</i>, include a variable in the
				>	lexical environment in which <i>code</i> is evaluated named <i>na
				>	me</i>, whose value is <i>value</i>. Each <i>value</i> must be a
				>	debuggee value. (This is not like a <code>with</code> statement:
				>	<i>code</i> may access, assign to, and delete the introduced bind
				>	ings without having any effect on the <i>bindings</i> object.)
n	480	Note that, like <code>executeInGlobal</code>, any decla	n	507	Note that, like <code>executeInGlobal</code>, any decla
	>	rations it contains affect the referent global object, even as<em		>	rations it contains affect the referent global object, even as <i
	>	>code</em> is evaluated in an environment extended according to<e		>	>code</i> is evaluated in an environment extended according to <i
	>	m>bindings</em>. (In the terms used by the ECMAScript specificati		>	>bindings</i>. (In the terms used by the ECMAScript specification
	>	on, the <code>VariableEnvironment</code> of the execution context		>	, the <code>VariableEnvironment</code> of the execution context f
	>	for<em>code</em> is the referent, and the<em>bindings</em> appea		>	or <i>code</i> is the referent, and the <i>bindings</i> appear in
	>	r in a new declarative environment, which is the eval code’s <cod		>	a new declarative environment, which is the eval code’s <code>Le
	>	e>LexicalEnvironment</code>.)		>	xicalEnvironment</code>.)
	481	</p>
	482	<p>		508	</p>
				509	<p>
	483	The<em>options</em> argument is as for <a href="Debugge		510	The <i>options</i> argument is as for <a href="Debugger
	>	r.Frame#eval" title="Debugger.Frame: Eval"><code>Debugger.Frame.p		>	.Frame#eval" title="Debugger.Frame: Eval"><code>Debugger.Frame.pr
	>	rototype.eval</code></a>.		>	ototype.eval</code></a>.
n	513	<code>forceLexicalInitializationByName(<em>binding</em>)<	n	540	<code>forceLexicalInitializationByName(<i>binding</i>)</c
	>	/code>		>	ode>
	514	</dt>
	515	<dd>		541	</dt>
				542	<dd>
	516	If<em>binding</em> is in an uninitialized state initializ		543	If <i>binding</i> is in an uninitialized state initialize
	>	e it to undefined and return true, otherwise do nothing and retur		>	it to undefined and return true, otherwise do nothing and return
	>	n false.		>	false.
n	519	<h4 id="Source_Metadata">	n	546	<h4>
n	526	<dt>	n
	527
	528	</dt>
n	535	<dd id="watermark">	n	559	<dd id='watermark'>
	536	sha256:769e72a8136b921b313d24b17ffc23ab290ce65b413ed8ba86		560	sha256:aba718a489abd262ff9a124f8c6e02ba7d63d2fd698c3fee4b
	>	e597904261acb2		>	f8677766f94c1e
t	542	<a href="https://hg.mozilla.org/mozilla-central/rev/7ae37	t	566	<a href="https://hg.mozilla.org/mozilla-central/rev/e91b2
	>	7917236">7ae377917236</a>		>	c85aacd">e91b2c85aacd</a>

Tools/Debugger-API/Debugger.Script (en-US)

2017-07-28T14:45:25-07:00

Edited by:

jimblandy

<h3>Content changes:</h3>

	Revision 1129321			Revision 1278959
n			n	7	<h1 id="debugger.script">
				8	Debugger.Script
				9	</h1>
n	10	<h2 id="Debugger.Script_for_JSScripts">	n	13	<h2 id="debugger.script-for-jsscripts">
n	58	<h2 id="Debugger.Script_for_WebAssembly">	n	61	<h2 id="debugger.script-for-webassembly">
n	76	<h2 id="Convention">	n	79	<h2 id="convention">
n	82	<h2 id="Accessor_Properties_of_the_Debugger.Script_Prototype_	n	85	<h2 id="accessor-properties-of-the-debugger.script-prototype-
	>	Object">		>	object">
n			n	92	<dt>
				93	<code>isGeneratorFunction</code>
				94	</dt>
				95	<dd>
				96	True if this instance refers to a <code>JSScript</code> f
				>	or a function defined with a <code>function*</code> expression or
				>	statement. False otherwise.
				97	</dd>
				98	<dt>
				99	<code>isAsyncFunction</code>
				100	</dt>
				101	<dd>
				102	True if this instance refers to a <code>JSScript</code> f
				>	or an async function, defined with an <code>async function</code>
				>	expression or statement. False otherwise.
				103	</dd>
n	111	Note that the display name may not be a proper JavaScri	n	126	Note that the display name may not be a proper JavaScri
	>	pt identifier, or even a proper expression: we attempt to find he		>	pt identifier, or even a proper expression: we attempt to find he
	>	lpful names even when the function is not immediately assigned as		>	lpful names even when the function is not immediately assigned as
	>	the value of some variable or property. Thus, we use <code><em>a		>	the value of some variable or property. Thus, we use <code><i>a<
	>	</em>/<em>b</em></code> to refer to the<em>b</em> defined within<		>	/i>/<i>b</i></code> to refer to the <i>b</i> defined within <i>a<
	>	em>a</em>, and <code><em>a</em><</code> to refer to a function		>	/i>, and <code><i>a</i><</code> to refer to a function that oc
	>	that occurs somewhere within an expression that is assigned to<e		>	curs somewhere within an expression that is assigned to <i>a</i>.
	>	m>a</em>. For example:		>	For example:
n	129	<strong>If the instance refers to a <code>JSScript</cod	n	144	<strong>If the instance refers to a <code>JSScript</cod
	>	e></strong>, the filename or URL from which this script’s code wa		>	e></strong>, the filename or URL from which this script’s code wa
	>	s loaded. If the <code>source</code> property is non-<code>null</		>	s loaded. For scripts created by <code>eval</code> or the <code>F
	>	code>, then this is equal to <code>source.url</code>.		>	unction</code> constructor, this may be a synthesized filename, s
				>	tarting with a valid URL and followed by information tracking how
				>	the code was introduced into the system; the entire string is no
				>	t a valid URL. For <code>Function.prototype</code>’s script, this
				>	is <code>null</code>. If this <code>Debugger.Script</code>’s <co
				>	de>source</code> property is non-<code>null</code>, then this is
				>	equal to <code>source.url</code>.
n	139	<p>	n
	140	<strong>If the instance refers to a <code>JSScript</cod		154	<strong>If the instance refers to a <code>JSScript</code>
	>	e></strong>, the number of the line at which this script’s code s		>	</strong>, the number of the line at which this script’s code sta
	>	tarts, within the file or document named by <code>url</code>.		>	rts, within the file or document named by <code>url</code>.
	141	</p>
	142	<p>
	143	<strong>If the instance refers to WebAssembly code</str
	>	ong>, throw a <code>TypeError</code>.
	144	</p>
n	150	<p>	n
	151	<strong>If the instance refers to a <code>JSScript</cod		160	<strong>If the instance refers to a <code>JSScript</code>
	>	e></strong>, the number of lines this script’s code occupies, wit		>	</strong>, the number of lines this script’s code occupies, withi
	>	hin the file or document named by <code>url</code>.		>	n the file or document named by <code>url</code>.
	152	</p>
	153	<p>
	154	<strong>If the instance refers to WebAssembly code</str
	>	ong>, throw a <code>TypeError</code>.
	155	</p>
n	213	<h2 id="Function_Properties_of_the_Debugger.Script_Prototype_	n	218	<h2 id="function-properties-of-the-debugger.script-prototype-
	>	Object">		>	object">
n	225	<strong>If the instance refers to a <code>JSScript</cod	n	230	<strong>If the instance refers to a <code>JSScript</cod
	>	e></strong>, return an array<em>L</em> describing the relationshi		>	e></strong>, return an array <i>L</i> describing the relationship
	>	p between bytecode instruction offsets and source code positions		>	between bytecode instruction offsets and source code positions i
	>	in this script.<em>L</em> is sparse, and indexed by source line n		>	n this script. <i>L</i> is sparse, and indexed by source line num
	>	umber. If a source line number<em>line</em> has no code, then<em>		>	ber. If a source line number <i>line</i> has no code, then <i>L</
	>	L</em> has no<em>line</em> property. If there is code for<em>line		>	i> has no <i>line</i> property. If there is code for <i>line</i>,
	>	</em>, then <code><em>L</em>[<em>line</em>]</code> is an array of		>	then <code><i>L</i>[<i>line</i>]</code> is an array of offsets o
	>	offsets of byte code instructions that are entry points to that		>	f byte code instructions that are entry points to that line.
	>	line.
n	321	<code>getLineOffsets(<em>line</em>)</code>	n	326	<code>getLineOffsets(<i>line</i>)</code>
				327	</dt>
	322	</dt>		328	<dd>
				329	<strong>If the instance refers to a <code>JSScript</code>
				>	</strong>, return an array of bytecode instruction offsets repres
				>	enting the entry points to source line <i>line</i>. If the script
				>	contains no executable code at that line, the array returned is
				>	empty.
	323	<dd>		330	</dd>
	324	<p>		331	<dt>
	325	<strong>If the instance refers to a <code>JSScript</cod		332	<code>getOffsetLocation(<i>offset</i>)</code>
	>	e></strong>, return an array of bytecode instruction offsets repr
	>	esenting the entry points to source line<em>line</em>. If the scr
	>	ipt contains no executable code at that line, the array returned
	>	is empty.
				333	</dt>
				334	<dd>
	326	</p>		335	<p>
	327	<p>
	328	<strong>If the instance refers to WebAssembly code</str
	>	ong>, throw a <code>TypeError</code>.
	329	</p>
	330	</dd>
	331	<dt>
	332	<code>getOffsetLocation(<em>offset</em>)</code>
	333	</dt>
	334	<dd>
	335	<p>
	336	<strong>If the instance refers to a <code>JSScript</cod		336	<strong>If the instance refers to a <code>JSScript</cod
	>	e></strong>, return an object describing the source code location		>	e></strong>, return an object describing the source code location
	>	responsible for the bytecode at<em>offset</em> in this script. T		>	responsible for the bytecode at <i>offset</i> in this script. Th
	>	he object has the following properties:		>	e object has the following properties:
n	355	<p>	n
	356	<strong>If the instance refers to WebAssembly code</str
	>	ong>, throw a <code>TypeError</code>.
	357	</p>
n	407	<code>setBreakpoint(<em>offset</em>,<em>handler</em>)</co	n	404	<code>setBreakpoint(<i>offset</i>, <i>handler</i>)</code>
	>	de>
	408	</dt>
	409	<dd>		405	</dt>
	410	<p>		406	<dd>
	411	<strong>If the instance refers to a <code>JSScript</cod
	>	e></strong>, set a breakpoint at the bytecode instruction at<em>o
	>	ffset</em> in this script, reporting hits to the <code>hit</code>
	>	method of<em>handler</em>. If<em>offset</em> is not a valid offs
	>	et in this script, throw an error.
	412	</p>		407	<p>
				408	<strong>If the instance refers to a <code>JSScript</cod
				>	e></strong>, set a breakpoint at the bytecode instruction at <i>o
				>	ffset</i> in this script, reporting hits to the <code>hit</code>
				>	method of <i>handler</i>. If <i>offset</i> is not a valid offset
				>	in this script, throw an error.
	413	<p>		409	</p>
				410	<p>
	414	When execution reaches the given instruction, SpiderMon		411	When execution reaches the given instruction, SpiderMon
	>	key calls the <code>hit</code> method of<em>handler</em>, passing		>	key calls the <code>hit</code> method of <i>handler</i>, passing
	>	a <a href="Debugger.Frame" title="Debugger.Frame"><code>Debugger		>	a <a href="Debugger.Frame" title="Debugger.Frame"><code>Debugger.
	>	.Frame</code></a> instance representing the currently executing s		>	Frame</code></a> instance representing the currently executing st
	>	tack frame. The <code>hit</code> method’s return value should be		>	ack frame. The <code>hit</code> method’s return value should be a
	>	a <a href="Conventions#resumption-values" title="Debugger API: Ge		>	<a href="Conventions#resumption-values" title="Debugger API: Gen
	>	neral Conventions: Resumption Values">resumption value</a>, deter		>	eral Conventions: Resumption Values">resumption value</a>, determ
	>	mining how execution should continue.		>	ining how execution should continue.
n	420	Any number of breakpoints may use the same<em>handler</	n	417	Any number of breakpoints may use the same <i>handler</
	>	em> object.		>	i> object.
n			n	425	</dd>
	428	<p>		426	<dt>
	429	<strong>If the instance refers to WebAssembly code</str		427	<code>getBreakpoints([<i>offset</i>])</code>
	>	ong>, throw a <code>TypeError</code>.
				428	</dt>
				429	<dd>
	430	</p>		430	<p>
	431	</dd>		431	<strong>If the instance refers to a <code>JSScript</cod
				>	e></strong>, return an array containing the handler objects for a
				>	ll the breakpoints set at <i>offset</i> in this script. If <i>off
				>	set</i> is omitted, return the handlers of all breakpoints set an
				>	ywhere in this script. If <i>offset</i> is present, but not a val
				>	id offset in this script, throw an error.
	432	<dt>
	433	<code>getBreakpoints([<em>offset</em>])</code>
	434	</dt>
	435	<dd>
	436	<p>		432	</p>
	437	<strong>If the instance refers to a <code>JSScript</cod
	>	e></strong>, return an array containing the handler objects for a
	>	ll the breakpoints set at<em>offset</em> in this script. If<em>of
	>	fset</em> is omitted, return the handlers of all breakpoints set
	>	anywhere in this script. If<em>offset</em> is present, but not a
	>	valid offset in this script, throw an error.
	438	</p>		433	<p>
				434	<strong>If the instance refers to WebAssembly code</str
				>	ong>, throw a <code>TypeError</code>.
	439	<p>		435	</p>
	440	<strong>If the instance refers to WebAssembly code</str		436	</dd>
	>	ong>, throw a <code>TypeError</code>.
				437	<dt>
				438	<code>clearBreakpoints(handler, [<i>offset</i>])</code>
				439	</dt>
				440	<dd>
	441	</p>		441	<p>
	442	</dd>		442	<strong>If the instance refers to a <code>JSScript</cod
				>	e></strong>, remove all breakpoints set in this <a href="Debugger
				>	" title="The Debugger object"><code>Debugger</code></a> instance
				>	that use <i>handler</i> as their handler. If <i>offset</i> is giv
				>	en, remove only those breakpoints set at <i>offset</i> that use <
				>	i>handler</i>; if <i>offset</i> is not a valid offset in this scr
				>	ipt, throw an error.
	443	<dt>
	444	<code>clearBreakpoints(handler, [<em>offset</em>])</code>
	445	</dt>
	446	<dd>
	447	<p>		443	</p>
	448	<strong>If the instance refers to a <code>JSScript</cod
	>	e></strong>, remove all breakpoints set in this <a href="Debugger
	>	" title="The Debugger object"><code>Debugger</code></a> instance
	>	that use<em>handler</em> as their handler. If<em>offset</em> is g
	>	iven, remove only those breakpoints set at<em>offset</em> that us
	>	e<em>handler</em>; if<em>offset</em> is not a valid offset in thi
	>	s script, throw an error.
	449	</p>		444	<p>
	450	<p>
	451	Note that, if breakpoints using other handler objects a		445	Note that, if breakpoints using other handler objects a
	>	re set at the same location(s) as<em>handler</em>, they remain in		>	re set at the same location(s) as <i>handler</i>, they remain in
	>	place.		>	place.
	452	</p>
	453	<p>		446	</p>
	454	<strong>If the instance refers to WebAssembly code</str
	>	ong>, throw a <code>TypeError</code>.
	455	</p>
	456	</dd>
	457	<dt>
	458	<code>clearAllBreakpoints([<em>offset</em>])</code>
	459	</dt>
	460	<dd>		447	</dd>
	461	<p>
	462	<strong>If the instance refers to a <code>JSScript</cod
	>	e></strong>, remove all breakpoints set in this script. If<em>off
	>	set</em> is present, remove all breakpoints set at that offset in
	>	this script; if<em>offset</em> is not a valid bytecode offset in
	>	this script, throw an error.
	463	</p>
	464	<p>
	465	<strong>If the instance refers to WebAssembly code</str
	>	ong>, throw a <code>TypeError</code>.
	466	</p>
	467	</dd>		448	<dt>
				449	<code>clearAllBreakpoints([<i>offset</i>])</code>
	468	<dt>		450	</dt>
				451	<dd>
				452	<strong>If the instance refers to a <code>JSScript</code>
				>	</strong>, remove all breakpoints set in this script. If <i>offse
				>	t</i> is present, remove all breakpoints set at that offset in th
				>	is script; if <i>offset</i> is not a valid bytecode offset in thi
				>	s script, throw an error.
				453	</dd>
				454	<dt>
	469	<code>isInCatchScope([<em>offset</em>])</code>		455	<code>isInCatchScope([<i>offset</i>])</code>
n	480	<h4 id="Source_Metadata">	n	466	<h4>
n	487	<dt>	n
	488
	489	</dt>
n	496	<dd id="watermark">	n	479	<dd id='watermark'>
	497	sha256:8157af920e7356ed18b7cc341e0b748660b1da7041eb862afe		480	sha256:093318b997b31f3aeaad346520e94df2a4f2b0de35065f9d5e
	>	896fc4cf5cd5aa		>	10cfaaf0b41067
t	503	<a href="https://hg.mozilla.org/mozilla-central/rev/7ae37	t	486	<a href="https://hg.mozilla.org/mozilla-central/rev/e91b2
	>	7917236">7ae377917236</a>		>	c85aacd">e91b2c85aacd</a>

Tools/Debugger-API/Debugger.Source (en-US)

2017-07-28T14:45:27-07:00

Edited by:

jimblandy

<h3>Content changes:</h3>

	Revision 1129319			Revision 1278961
n			n	7	<h1 id="debugger.source">
				8	Debugger.Source
				9	</h1>
n	16	<h2 id="Debugger.Source_for_JavaScript">	n	19	<h2 id="debugger.source-for-javascript">
n	31	<h2 id="Debugger.Source_for_WebAssembly">	n	34	<h2 id="debugger.source-for-webassembly">
n	43	<h2 id="Convention">	n	46	<h2 id="convention">
n	49	<h2 id="Accessor_Properties_of_the_Debugger.Source_Prototype_	n	52	<h2 id="accessor-properties-of-the-debugger.source-prototype-
	>	Object">		>	object">
n	64	<strong>If the instance refers to WebAssembly code</str	n	67	<strong>If the instance refers to WebAssembly code</str
	>	ong>, the serialized text representation. The format is yet to be		>	ong>, the serialized text representation. The format is yet to be
	>	specified in the WebAssembly standard. Currently, the text is an		>	specified in the WebAssembly standard. Currently, the text is an
	>	s-expression based syntax.		>	s-expression based syntax. The text generation is disabled if th
				>	e Debugger has the <code>allowWasmBinarySource</code> property se
				>	t, the <code>"[wasm]"</code> value will be returned in this case.
				68	</p>
	65	</p>		69	</dd>
				70	<dt>
				71	<code>binary</code>
				72	</dt>
				73	<dd>
				74	<strong>If the instance refers to WebAssembly code</stron
				>	g> and the Debugger has the <code>allowWasmBinarySource</code> pr
				>	operty set, a Uint8Array that contains the WebAssembly bytecode.
n	72	<strong>If the instance refers to JavaScript source</st	n	81	<strong>If the instance refers to JavaScript source</st
	>	rong>, the URL from which this source was loaded, if this source		>	rong>, the filename or URL from which this script’s code was load
	>	was loaded from a URL. Otherwise, this is <code>undefined</code>.		>	ed. For scripts created by <code>eval</code> or the <code>Functio
	>	Source may be loaded from a URL in the following ways:		>	n</code> constructor, this may be a synthesized filename, startin
				>	g with a valid URL and followed by information tracking how the c
				>	ode was introduced into the system; the entire string is not a va
				>	lid URL. For <code>Function.prototype</code>’s script, this is <c
				>	ode>null</code>. Source may be loaded from a URL in the following
				>	ways:
n	92	(Note that code passed to <code>eval</code>, the <code>	n	101	(Note that code passed to <code>eval</code>, the <code>
	>	Function</code> constructor, or a similar function is<em>not</em>		>	Function</code> constructor, or a similar function is <i>not</i>
	>	considered to be loaded from a URL; the <code>url</code> accesso		>	considered to be loaded from a URL; the <code>url</code> accessor
	>	r on <code>Debugger.Source</code> instances for such sources shou		>	on <code>Debugger.Source</code> instances for such sources shoul
	>	ld return <code>undefined</code>.)		>	d return <code>undefined</code>.)
n	103	<strong>If the instance refers to JavaScript source</st	n	112	<strong>If the instance refers to JavaScript source</st
	>	rong>, if this source was produced by a minimizer or translated f		>	rong>, if this source was produced by a minimizer or translated f
	>	rom some other language, and we know the URL of a <strong>source		>	rom some other language, and we know the URL of a <b>source map</
	>	map</strong> document relating the source positions in this sourc		>	b> document relating the source positions in this source to the c
	>	e to the corresponding source positions in the original source, t		>	orresponding source positions in the original source, then this p
	>	hen this property’s value is that URL. Otherwise, this is <code>n		>	roperty’s value is that URL. Otherwise, this is <code>null</code>
	>	ull</code>.		>	.
n	109	This property is writable, so you can change the source	n	118	This property is writable, so you can change the source
	>	map URL by setting it. All Debugger.Source objects referencing t		>	map URL by setting it. All Debugger.Source objects referencing t
	>	he same source will see the change. Setting an empty string has n		>	he same source will see the change. Setting an empty string has n
	>	o affect and will not change existing value.		>	o effect and will not change existing value.
n			n	125	<code>displayURL</code>
				126	</dt>
				127	<dd>
				128	If the script had a special <code>//# sourceURL</code> co
				>	mment, as described in the source maps specification, then this p
				>	roperty’s value holds the string that was given. Otherwise, this
				>	is <code>null</code>.
				129	</dd>
				130	<dt>
n	135	Source belongs to a DOM element if it was assigned	n	150	Source belongs to a DOM element if it was assigned
	>	to one of the element’s event handler IDL attributes as a string.		>	to one of the element’s event handler IDL attributes as a string.
	>	(Note that one may assign both strings and functions to DOM elem		>	(Note that one may assign both strings and functions to DOM elem
	>	ents’ event handler IDL attributes. If one assigns a function, th		>	ents’ event handler IDL attributes. If one assigns a function, th
	>	at function’s script’s source does<em>not</em> belong to the DOM		>	at function’s script’s source does <i>not</i> belong to the DOM e
	>	element; the function’s definition must appear elsewhere.)		>	lement; the function’s definition must appear elsewhere.)
n			n	184	<code>"Function.prototype"</code>, for <code>Functi
				>	on.prototype</code> internally generated code.
				185	</p>
				186	</li>
				187	<li>
				188	<p>
n	226	If a <code><script></code> element was dynamicall	n	246	If a <code><script></code> element was dynamicall
	>	y inserted into a document, then these accessors refer to the cal		>	y inserted into a document, then these accessors refer to the cal
	>	l that actually caused the script to run—usually the call that ma		>	l that actually caused the script to run—usually the call that ma
	>	de the element part of the document. Thus, they do<em>not</em> re		>	de the element part of the document. Thus, they do <i>not</i> ref
	>	fer to the call that created the element; stored the source as th		>	er to the call that created the element; stored the source as the
	>	e element’s text child; made the element a child of some uninsert		>	element’s text child; made the element a child of some uninserte
	>	ed parent node that was later inserted; or the like.		>	d parent node that was later inserted; or the like.
n	236	<h4 id="Source_Metadata">	n	256	<h4>
n	243	<dt>	n
	244
	245	</dt>
n	252	<dd id="watermark">	n	269	<dd id='watermark'>
	253	sha256:bdd5ceee81b89b00902d45c02aa80a3028ae12bad29ce6dca7		270	sha256:5ca245813db96628aab1c78b803355eb2aa8c575839c67eb7d
	>	6c6b5a8505a4ee		>	7bde177898df88
t	259	<a href="https://hg.mozilla.org/mozilla-central/rev/7ae37	t	276	<a href="https://hg.mozilla.org/mozilla-central/rev/e91b2
	>	7917236">7ae377917236</a>		>	c85aacd">e91b2c85aacd</a>

Tools/Debugger-API/Debugger.Memory (en-US)

2017-07-28T14:45:28-07:00

Edited by:

jimblandy

<h3>Content changes:</h3>

	Revision 1090319			Revision 1278963
n	236	</li>	n
	237	<li>“FINISH_LARGE_EVALUATE”
n	663	sha256:0d543c1b3c35ed2df43bf641ebbdda184fabd29ad3379a13ff	n	661	sha256:2c1529d6932efec8c624a6f1f366b09cb7fce625a6468657fa
	>	cb89ebb1f24d4e		>	b81788240bc7ae
t	669	<a href="https://hg.mozilla.org/mozilla-central/rev/251fc	t	667	<a href="https://hg.mozilla.org/mozilla-central/rev/e91b2
	>	cc1f62b">251fccc1f62b</a>		>	c85aacd">e91b2c85aacd</a>

MDN/Contribute/Onboarding (en-US)

2017-07-28T14:51:42-07:00

Created by:

jswisher

Content changes:

<p>This document covers topics that a professional writer who will be working full-time on MDN needs to know to get started. If you just contribute to MDN on a casual basis, you don't need to worry about this; you can just dive and<a href="/en-US/docs//MDN/Getting_started"> get started</a>. Or you can peruse these topics at your leisure if you are curious.</p> <h2>What is MDN web docs?</h2> <ul> <li><a href="https://wiki.mozilla.org/MDN/">Mission and vision</a></li> <li><a href="https://wiki.mozilla.org/Engagement/MDN_Durable_Team">Mozilla's MDN staff team</a></li> </ul> <h2>Guidelines</h2> <p>These are things that professional writers typically want to know before starting work in a new environment.</p> <ul> <li><a href="/en-US/docs/MDN/Contribute/Guidelines/Does_this_belong_on_MDN">What belongs on MDN?</a></li> <li>Editorial policies (to be written)</li> <li><a href="/en-US/docs/MDN/Contribute/Guidelines/Writing_style_guide">Writing style guide</a></li> <li><a href="/en-US/docs/MDN/Contribute/Guidelines">Other guidelines</a></li> </ul> <h2>Basic usage of the MDN wiki</h2> <p>These articles describe basic information you need to get started with creating content on MDN.</p> <ul> <li><a href="/en-US/docs/MDN/Contribute/Howto/Create_an_MDN_account">Create an account</a> — For employees of partner organizations, we recommend that you sign up using an email address that reflects your employer.</li> <li><a href="/en-US/docs/MDN/Contribute/Howto/Write_an_API_reference">How to write an API reference</a></li> <li><a href="/en-US/docs/MDN/Contribute/Editor">Using the MDN editor UI</a> (to be updated)</li> <li><a href="/en-US/docs/MDN/Contribute/Editor/Source_mode">How and when to use source mode</a></li> <li><a href="/en-US/docs/MDN/Contribute/Howto/Tag">How to tag pages</a></li> <li><a href="/en-US/docs/MDN/Contribute/Structures/Macros">Using macros</a></li> <li><a href="/en-US/docs/MDN/Contribute/Structures/Macros/Commonly-used_macros">Commonly-used macros</a></li> <li>Troubleshooting (to be written) <ul> <li>Updating macro content</li> <li>Macro errors</li> <li>Unable to save page</li> </ul> </li> </ul> <h2>Advanced usage</h2> <p>These articles describe features of the MDN wiki that you might not need right away, but that you are likely to run into eventually.</p> <ul> <li><a href="/en-US/docs/MDN/Contribute/Structures/Live_samples">Live samples</a></li> <li>Interactive samples (to be written)</li> <li><a href="/en-US/docs/MDN/Contribute/Structures">Structures used within documents</a></li> <li>Compatibility tables (outdated; to be updated)</li> <li><a href="/en-US/docs/MDN/Contribute/Editor/Images">Attaching images</a> using the <a href="/en-US/docs/MDN/Contribute/Editor/Basics#The_attachments_box">attachments box</a> — attaching SVG images requires special privileges; ask a Mozilla MDN staff member for help.</li> <li><a href="/en-US/docs/MDN/Contribute/Structures/Quicklinks">Sidebars with QuickLinks</a></li> <li><a href="/en-US/docs/MDN/Contribute/Tools/Page_moving">Moving pages</a></li> <li><a href="/en-US/docs/MDN/Contribute/Localize/Translating_pages">Translating pages</a></li> <li><a href="/en-US/docs/MDN/Contribute/Tools/Add-ons_and_plug-ins">MDN-related add-ons</a></li> </ul> <p> </p> <p> </p> <p> </p>

View Page

Edit Page

History

Mozilla/Developer_guide/Build_Instructions/Incremental_builds_with_filesystem_watching (en-US)

2017-07-28T14:53:42-07:00

Created by:

nalexander

Content changes:

<div class="note"> <p>This page covers the steps needed to incrementally update a bleeding-edge, development version of <strong>Firefox for Desktop</strong> using <a href="https://facebook.github.io/watchman/">watchman</a> to monitor filesystem changes and automatically generate the changed build outputs.  Welcome, we're delighted to see you! :)<br /> <br /> If you're having trouble following this documentation or hit a roadblock you can't get around, please contact one of:</p> <ul> <li>Nick Alexander at <a class="link-mailto" href="mailto:nalexander@mozilla.com" rel="freelink">nalexander@mozilla.com</a></li> <li>Brian Grinstead at <a class="link-mailto" href="mailto:bgrinstead@mozilla.com" rel="freelink">bgrinstead@mozilla.com</a></li> <li>Gregory Szorc at <a class="link-mailto" href="mailto:gszorc@mozilla.com" rel="freelink">gszorc@mozilla.com</a></li> </ul> <p>directly so we can solve the problem for you and every new contributor after you.</p> </div> <p>For additional information, see the general Firefox <a class="internal" href="/en-US/docs/Mozilla/Developer_guide/Build_Instructions" title="/en-US/docs/Developer_Guide/Build_Instructions">build documentation</a>.</p> <h2 id="Artifact_builds">Incremental builds with filesystem watching</h2> <p>Firefox for Desktop supports a <strong>fast build build mode</strong> called <a href="/docs/Artifact_builds">artifact mode</a>.  When you're using artifact mode, you can opt-in to an even faster incremental front-end build process.</p> <h2 id="Prerequisites">Prerequisites</h2> <p>You must:</p> <ul> <li>be using <a href="/docs/Artifact_builds">artifact builds</a></li> <li>be building Firefox for Desktop</li> <li>have built Firefox for Desktop successfully</li> <li>have <a href="https://facebook.github.io/watchman/">watchman</a> installed</li> </ul> <h2 id="Building">Installing pywatchman</h2> <p>Incremental front-end builds require the pywatchman wrapper around watchman to be installed.  mach watch</p> <p>Most Desktop developers on Mac OS X or Linux should find that</p> <pre> ./mach watch </pre> <p>just works, and incrementally rebuilds local JS, CSS and packaged (e.g. images and other asset) files.</p> <h2 id="Restrictions">Restrictions</h2> <h3 id="Things_that_are_supported">Things that are supported</h3> <ul> <li>Modifying JavaScript, (X)HTML, and CSS resources; and string properties and DTD files.</li> </ul> <p>Essentially everything updated by <code>mach build faster</code> should work with <code>mach watch</code>.</p> <h3 id="Things_that_are_not_supported">Things that are not supported</h3> <ul> <li>Modifying build system configuration and definitions.  Kill <code>mach watch</code>, run <code>mach build faster</code> to pick up the changes to the build system istelf, and restart <code>mach watch</code>.</li> </ul> <h2 id="Troubleshooting">Troubleshooting</h2> <p>Discussion is best started on the <a href="https://lists.mozilla.org/listinfo/dev-builds">dev-builds mailing list</a>.  Questions are best raised in #build on <a href="https://wiki.mozilla.org/IRC">IRC</a>.  Please file bugs in <em>Core :: Build Config</em>, blocking {{ Bug("1384241") }}.</p>

View Page

Edit Page

History

Web/API/Window/open (en-US)

2017-07-28T14:57:35-07:00

Edited by:

Sheppy

Comment:

Heavily refactored the intro and syntax material. Much more work needed.

Tag changes:

	Revision 1271577			Revision 1278975
t	1	"API" "DOM" "Method" "NeedsCompatTable" "NeedsMarkupWork" "NeedsU	t	1	"API" "DOM" "Method" "NeedsCompatTable" "NeedsMarkupWork" "NeedsU
	>	pdate" "Window"		>	pdate" "Reference" "Window" "open"

<h3>Content changes:</h3>

	Revision 1271577			Revision 1278975
n	11	Loads a resource into either a new browsing context (such a	n	11	The {{domxref("Window")}} interface's <strong><code>op
	>	s a window) or one that already exists, depending on the specifie		>	en()</code></strong> method loads the specified resource into the
	>	d parameters.		>	browsing context (window or tab) with the specified name. If the
				>	name doesn't exist, then a new window is opened and the specifie
				>	d resource is loaded into its browsing context.
n	17	<code>var <var>windowObjectReference</var> = window.open(<var>str	n	17	<code>var <em>window</em> = window.open(<em>url</em>, <em>windowN
	>	Url</var>, <var>strWindowName</var>, [<var>strWindowFeatures</var		>	ame</em>, [<var>windowFeatures</var>]);</code>
	>	>]);</code>
n	19	<h2 id="Return_value_and_parameters">	n	19	<h3 id="Return_value_and_parameters">
	20	Return value and parameters		20	Parameters
	21	</h2>		21	</h3>
n	24	<code>windowObjectReference</code>	n	24	<code>url</code>
	25	</dt>
	26	<dd>
	27	A reference to the newly created window. If the call fail
	>	ed, it will be <code>null</code> instead. The reference can acces
	>	s properties and methods of the new window provided it complies w
	>	ith <a href="https://developer.mozilla.org/en-US/docs/Web/Securit
	>	y/Same-origin_policy">Same-origin policy</a> security requirement
	>	s.
	28	</dd>
	29	<dt>		25	</dt>
	30	<code>strUrl</code>
	31	</dt>
	32	<dd>
	33	The URL to be loaded in the newly opened window. <code>st
	>	rUrl</code> can be a path or URL to an HTML page, image file
	>	, or any other resource supported by the browser. It can also be
	>	a blank string ("") in which case a blank page is loaded.
	34	</dd>		26	<dd>
	35	<dt>		27	A {{domxref("DOMString")}} indicating the URL of the reso
				>	urce to be loaded. This can be a path or URL to an HTML page, ima
				>	ge file, or any other resource which is supported by the browser.
				>	If the empty string ("") is specified as <code>url</code>, a bla
				>	nk page is opened into the targeted browsing context.
	36	<code>strWindowName</code>
	37	</dt>
	38	<dd>		28	</dd>
	39	A name for the new window. The name can be used as the ta
	>	rget of links and forms using the <code>target</code> attribute o
	>	f {{HTMLElement("a")}} or {{HTMLElement("form")}} elements. The n
	>	ame should not contain whitespace. Note that <code>strWindowName<
	>	/code> does <strong>not</strong> specify the title of the new win
	>	dow.
	40	</dd>
	41	<dt>
	42	<code>strWindowFeatures</code>
	43	</dt>		29	<dt>
				30	<code>windowName</code>
				31	</dt>
				32	<dd>
				33	A {{domxref("DOMString")}} specifying the name of the bro
				>	wsing context (window or tab) into which to load the specified re
				>	source; if the name doesn't indicate an existing context, a new w
				>	indow is created and is given the name specified by <code>windowN
				>	ame</code>. This name can then be used as the target of links and
				>	forms by specifying it as the <code>target</code> attribute of {
				>	{HTMLElement("a")}} or {{HTMLElement("form")}} elements. The name
				>	should not contain whitespace. Keep in mind that this will <em>n
				>	ot</em> be used as the window's displayed title.
	44	<dd>		34	</dd>
	45	An optional parameter listing the features (size, positio		35	<dt>
	>	n, scrollbars, etc.) of the new window as a {{domxref("DOMString"
	>	)}}. The string must not contain any whitespace, and each feature
	>	name and value must be separated by a comma. See {{anch("Window
	>	features")}} below for details of the features that can be listed
	>	in this parameter.
				36	<code>windowFeatures</code> {{optional_inline}}
				37	</dt>
				38	<dd>
				39	A {{domxref("DOMString")}} containing a comma-separated l
				>	ist of window features given with their corresponding values in t
				>	he form "name=value". These features include options such as the
				>	window's default size and position, whether or not to include scr
				>	oll bars, and so forth. There must be no whitespace in the string
				>	. See {{anch("Window features")}} below for documentation of each
				>	of the features that can be specified.
t			t	42	<h3>
				43	Return value
				44	</h3>
				45	<p>
				46	A {{domxref("Window")}} object representing to the newly cr
				>	eated window. If the window couldn't be opened, the returned valu
				>	e is instead <code>null</code>. The returned <code>Window</code>
				>	reference can be used to access properties and methods of the new
				>	window as long as it complies with <a href="https://developer.mo
				>	zilla.org/en-US/docs/Web/Security/Same-origin_policy">Same-origin
				>	policy</a> security requirements.
				47	</p>

Mozilla/Developer_guide/Build_Instructions/Incremental_builds_with_filesystem_watching (en-US)

2017-07-28T14:59:05-07:00

Edited by:

nalexander

Comment:

Trying to make the extracted highlight in Slack reflect the page content, not just the "see here for more" line at the top.

Tag changes:

	Revision 1278971			Revision 1278977
t	1	"Artifact builds" "Build documentation" "Developing Mozilla" "Fir	t	1	"Artifact builds" "Build documentation" "Developing Mozilla" "Fir
	>	efox" "Firefox for Android"		>	efox"

<h3>Content changes:</h3>

	Revision 1278971			Revision 1278977
n	22	directly so we can solve the problem for you and every ne	n	22	directly so we can solve the problem for you and every ne
	>	w contributor after you.		>	w contributor after you.  For additional information, see th
				>	e general Firefox <a class="internal" href="/en-US/docs/Mozilla/D
				>	eveloper_guide/Build_Instructions" title="/en-US/docs/Developer_G
				>	uide/Build_Instructions">build documentation</a>.
n	25	<p>	n	25	<h2 id="Incremental_builds_with_filesystem_watching">
	26	For additional information, see the general Firefox <a clas
	>	s="internal" href="/en-US/docs/Mozilla/Developer_guide/Build_Inst
	>	ructions" title="/en-US/docs/Developer_Guide/Build_Instructions">
	>	build documentation</a>.
	27	</p>
	28	<h2 id="Artifact_builds">
n	32	Firefox for Desktop supports a <strong>fast build build mod	n	29	Firefox for Desktop supports a fast build build mode called
	>	e</strong> called <a href="/docs/Artifact_builds">artifact mode</		>	<a href="/docs/Artifact_builds">artifact mode</a>.  When yo
	>	a>.  When you're using artifact mode, you can opt-in to an e		>	u're using artifact mode, you can opt-in to an <strong>even faste
	>	ven faster incremental front-end build process.		>	r incremental front-end build process</strong>.
t	50	<h2 id="Building">	t	47	<h2 id="Installing_pywatchman">

Mozilla/Add-ons/WebExtensions/API/tabs/PageSettings (en-US)

2017-07-28T14:59:20-07:00

Created by:

wbamberg

Content changes:

<div>{{AddonSidebar}}</div> <p>The type <strong><code>tabs.PageSettings</code></strong> is used to control how the contents of a tab is printed.</p> <h2 id="Type">Type</h2> <p>Values of this type are objects. They contain the following properties:</p> <dl class="reference-values"> <dt><code>footerCenter</code> {{optional_inline}}</dt> <dd><code>string</code>. The text for the page's center footer. Default: ''.</dd> <dt><code>footerLeft</code> {{optional_inline}}</dt> <dd><code>string</code>. The text for the page's left footer. Default: '&PT'.</dd> <dt><code>footerRight</code> {{optional_inline}}</dt> <dd><code>string</code>. The text for the page's right footer. Default: '&D'.</dd> <dt><code>headerCenter</code> {{optional_inline}}</dt> <dd><code>string</code>. The text for the page's center header. Default: ''.</dd> <dt><code>headerLeft</code> {{optional_inline}}</dt> <dd><code>string</code>. The text for the page's left header. Default: '&T'.</dd> <dt><code>headerRight</code> {{optional_inline}}</dt> <dd><code>string</code>. The text for the page's right header. Default: '&U'.</dd> <dt><code>marginBottom</code></dt> <dd><code>number</code>. The margin between the page content and the bottom edge of the paper (inches). Default: 0.5.</dd> <dt><code>marginLeft</code></dt> <dd><code>number</code>. The margin between the page content and the left edge of the paper (inches). Default: 0.5.</dd> <dt><code>marginRight</code></dt> <dd><code>number</code>. The margin between the page content and the right edge of the paper (inches). Default: 0.5.</dd> <dt><code>marginTop</code></dt> <dd><code>number</code>. The margin between the page content and the top edge of the paper (inches). Default: 0.5.</dd> <dt><code>orientation </code> {{optional_inline}}</dt> <dd><code>integer</code>. Page orientation: 0 means "portrait", 1 means "landscape". Default: 0.</dd> <dt><code>paperHeight </code>{{optional_inline}}</dt> <dd><code>number</code>. The paper height in paper size units. Default: 11.0.</dd> <dt><code>paperSizeUnit</code> {{optional_inline}}</dt> <dd><code>integer</code>. The paper size unit: 0 = inches, 1 = millimeters. Default: 0.</dd> <dt><code>paperWidth</code> {{optional_inline}}</dt> <dd><code>number</code>. The paper width in paper size units. Default: 8.5.</dd> <dt><code>scaling</code> {{optional_inline}}</dt> <dd><code>number</code>. Page content scaling factor. 1 means 100% or normal size. Default: 1.</dd> <dt><code>showBackgroundColors</code> {{optional_inline}}</dt> <dd><code>boolean</code>. Whether the page background colors should be shown. Default: false.</dd> <dt><code>showBackgroundImages</code> {{optional_inline}}</dt> <dd><code>boolean</code>. Whether the page background images should be shown. Default: false.</dd> <dt><code>shrinkToFit</code> {{optional_inline}}</dt> <dd><code>boolean</code>. Whether the page content should shrink to fit the page width (overrides scaling). Default: true.</dd> </dl> <h2 id="Browser_compatibility">Browser compatibility</h2> <p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> <p>{{WebExtExamples}}</p> <div class="note"><strong>Acknowledgements</strong> <p>Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.</p> </div>

View Page

Edit Page

History

Mozilla/Add-ons/WebExtensions/API/tabs/Tab (en-US)

2017-07-28T15:00:05-07:00

Edited by:

wbamberg

<h3>Content changes:</h3>

	Revision 1272035			Revision 1278981
t	33	autoDiscardable {{optional_inline}}	t	33	<code>autoDiscardable</code> {{optional_inline}}

Web/API/SVGTests (en-US)

2017-07-28T15:00:37-07:00

Edited by:

jpmedley

<h3>Content changes:</h3>

+    <h2 id="Browser_compatibility">
+              {{CompatVersionUnknown}}
+            </td>
+            <td>
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <code>hasExension()</code>
+            </td>
+            <td>
+              {{CompatChrome(47)}} (removed)<sup>[1]</sup>
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <code>requiredFeatures</code>
+            </td>
+            <td>
+              {{CompatChrome(59)}} (removed)<sup>[1]</sup>
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <code>hasExension()</code>
+            </td>
+            <td>
+              {{CompatChrome(47)}} (removed)<sup>[1]</sup>
+            </td>
+            <td>
+              {{CompatChrome(47)}} (removed)<sup>[1]</sup>
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <code>requiredFeatures</code>
+            </td>
+            <td>
+              {{CompatChrome(59)}} (removed)<sup>[1]</sup>
+            </td>
+            <td>
+              {{CompatChrome(59)}} (removed)<sup>[1]</sup>
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+      [1] Removed because it is not part of the SVG2 spec.
->

Web/API/SVGTests (en-US)

2017-07-28T15:01:50-07:00

Edited by:

jpmedley

<h3>Content changes:</h3>

	Revision 1278983			Revision 1278985
n	18	{{domxref("SVGTests.requiredFeatures")}} {{ReadOnlyInline	n	18	{{domxref("SVGTests.requiredFeatures")}} {{ReadOnlyInline
	>	}} {{deprecated_inline}}		>	}} {{obsolete_inline()}}
t	41	{{domxref("SVGTests.hasExtension()")}} {{ReadOnlyInline}}	t	41	{{domxref("SVGTests.hasExtension()")}} {{ReadOnlyInline}}
	>	{{deprecated_inline}}		>	{{obsolete_inline()}}

Web/API/SourceBuffer (en-US)

2017-07-28T15:17:17-07:00

Edited by:

rhues

<h3>Content changes:</h3>

	Revision 1205033			Revision 1278989
t	66	Controls the timestamp for the start of the <a href="http	t	66	Controls the timestamp for the start of the <a href="http
	>	s://w3c.github.io/media-source/#append-window">append window</a>.		>	s://w3c.github.io/media-source/#append-window">append window</a>.
	>	This is a timestamp range that can be used to filter what media		>	This is a timestamp range that can be used to filter what media
	>	data is appended to the <code>SourceBuffer</code>. Coded media fr		>	data is appended to the <code>SourceBuffer</code>. Coded media fr
	>	ames with timestamps wthin this range will be appended, whereas t		>	ames with timestamps within this range will be appended, whereas
	>	hose outside the range will be filtered out.		>	those outside the range will be filtered out.

Mozilla/Add-ons/WebExtensions/API/tabs/PageSettings (en-US)

2017-07-28T15:49:37-07:00

Edited by:

wbamberg

<h3>Content changes:</h3>

	Revision 1278979			Revision 1278997
n	57	<code>marginBottom</code>	n	57	<code>marginBottom</code> {{optional_inline}}
n	63	<code>marginLeft</code>	n	63	<code>marginLeft</code> {{optional_inline}}
n	69	<code>marginRight</code>	n	69	<code>marginRight</code> {{optional_inline}}
t	75	<code>marginTop</code>	t	75	<code>marginTop</code> {{optional_inline}}

Web/API/Screen/availHeight (en-US)

2017-07-28T16:27:16-07:00

Edited by:

Sheppy

<h3>Content changes:</h3>

+      If your web application needs to open a new window, such as
->
+ a tool palette, and wants to position it so that it occupies the
->
+ entire vertical space available, you can do so using code simila
+r to what's seen here.
+    <p>
+      In the main window, when it's time to open the palette, cod
+e like the following is used.
+    </p>
+    <pre class="brush: html">
+let paletteWindow = window.open("palettes.html", "Palette", "left
+=0, top=0, width=200");
+    <p>
+      The palette window's HTML, in <code>palettes.html</code>, h
+as JavaScript code of its own, which is executed as soon as the w
+indow is created. It doesn't even need to wait for any particular
+ event (or any event at all). That code handles resizing the wind
+ow based on the available space:
+    </p>
+    <pre class="brush: js">
+window.outerHeight = window.screen.availHeight;
+</pre>
+    <p>
+      The result is something similar to the below:
+    </p>
+    <p>
+      &nbsp;
+    </p>

Web/API/Screen/availHeight (en-US)

2017-07-28T16:44:24-07:00

Edited by:

Sheppy

Comment:

Finished cleanup for SEO and content completeness

Tag changes:

	Revision 1279005			Revision 1279009
t	1	"API" "CSSOM View" "NeedsCompatTable" "NeedsMarkupWork" "NeedsSpe	t	1	"API" "CSSOM View" "NeedsBrowserCompatibility" "Property" "Refere
	>	cTable" "Property" "Reference" "Référence"		>	nce" "Screen size" "availHeight"

<h3>Content changes:</h3>

+    <p>
+      You can similarly use {{domxref("Screen.availWidth")}} to g
+et the number of pixels which are horizontally available to the b
+rowser for its use.
+    </p>
+let paletteWindow = window.open("palettes.html", "Panels", "left=
->
+, top=0, width=200");
+      The result is something similar to the below:. Note the Pan
+els window filling all available vertical space at the left of th
+e screen.
+    </p>
+    <p>
+      <a href="https://mdn.mozillademos.org/files/15247/screen-av
+ailHeight.png"><img alt="Screenshot of the example for Screen.ava
+ilHeight" src="https://mdn.mozillademos.org/files/15247/screen-av
+ailHeight.png" style="height:338px; width:600px"></a>
+    <h2 id="Browser_Compatibility">
+      Browser compatibility
+    </h2>
+    <div>
+      {{CompatibilityTable}}
+    </div>
+    <div id="compat-desktop">
+      <table class="compat-table">
+        <tbody>
+          <tr>
+            <th>
+              Feature
+            </th>
+            <th>
+              Chrome
+            </th>
+            <th>
+              Firefox (Gecko)
+            </th>
+            <th>
+              Internet Explorer
+            </th>
+            <th>
+              Opera
+            </th>
+            <th>
+              Safari (WebKit)
+            </th>
+          </tr>
+          <tr>
+            <td>
+              Basic support
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{GeckoCompatDesktop("1.9.2")}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatVersionUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <div id="compat-mobile">
+      <table class="compat-table">
+        <tbody>
+          <tr>
+            <th>
+              Feature
+            </th>
+            <th>
+              Android Webview
+            </th>
+            <th>
+              Chrome for Android
+            </th>
+            <th>
+              Firefox Mobile (Gecko)
+            </th>
+            <th>
+              Firefox OS
+            </th>
+            <th>
+              IE Mobile
+            </th>
+            <th>
+              Opera Mobile
+            </th>
+            <th>
+              Safari Mobile
+            </th>
+          </tr>
+          <tr>
+            <td>
+              Basic support
+            </td>
+            <td>
+              CompatUnknown
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{GeckoCompatMobile("1.9.2")}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+            <td>
+              {{CompatUnknown}}
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+    <p>
+      &nbsp;
+    </p>
+    <h2 id="See_also">
+      See also
+    </h2>
+    <ul>
+      <li>{{domxref("Window")}}
+      </li>
+      <li>{{domxref("Screen")}}
+      </li>
+      <li>{{domxref("Screen.availWidth")}}
+      </li>
+      <li>{{domxref("Window.height")}}
+      </li>
+    </ul>
+    <p>
+      &nbsp;
+    </p>

Web/API/Screen/availHeight (en-US)

2017-07-28T16:44:49-07:00

Edited by:

Sheppy

<h3>Content changes:</h3>

	Revision 1279009			Revision 1279011
n	89	<h2 id="Browser_Compatibility">	n	89	<h2 id="Browser_compatibility">
n	126	{{GeckoCompatDesktop("1.9.2")}}	n	126	{{CompatGeckoDesktop("1.9.2")}}
t	181	{{GeckoCompatMobile("1.9.2")}}	t	181	{{CompatGeckoMobile("1.9.2")}}

Mozilla/Add-ons/WebExtensions/API/tabs/PageSettings (en-US)

2017-07-28T17:19:21-07:00

Edited by:

wbamberg

Content changes:

Web/CSS/border-bottom-left-radius (en-US)

2017-07-28T20:26:13-07:00

Edited by:

akashchandragupta

<h3>Content changes:</h3>

+/* the corner is a circle */
+/*  */
+border-bottom-left-radius: 20%;
+border-bottom-left-radius: 20% 20%;
+border-bottom-left-radius: 20% 10%;

Web/CSS/border-bottom-left-radius (en-US)

2017-07-28T20:38:49-07:00

Edited by:

akashchandragupta

<h3>Content changes:</h3>

	Revision 1279019			Revision 1279021
t	18	/* the corner is a circle */	t	18	/* Percentage values */
	19	/* */		19	border-bottom-left-radius: 20%; /* corner of a circle if box is a
				>	square or else corner of a rectangle */
	20	border-bottom-left-radius: 20%;		20	border-bottom-left-radius: 20% 20%; /* same as above / / horizo
				>	ntal vertical */
	21	border-bottom-left-radius: 20% 20%;		21	border-bottom-left-radius: 20% 10%; /* horizontal vertical */
	22
	23	border-bottom-left-radius: 20% 10%;

Web/CSS/border-bottom-left-radius (en-US)

2017-07-28T20:41:38-07:00

Edited by:

akashchandragupta

<h3>Content changes:</h3>

	Revision 1279021			Revision 1279023
t	20	border-bottom-left-radius: 20% 20%; /* same as above / / horizo	t	20	border-bottom-left-radius: 20% 20%; /* same as above / / 20% of
	>	ntal vertical */		>	horizontal/width and 20% of vertical/height */
	21	border-bottom-left-radius: 20% 10%; /* horizontal vertical */		21	border-bottom-left-radius: 20% 10%; /* 20% of horizontal/width an
				>	d 10% of vertical/height */

Web/CSS/border-bottom-left-radius (en-US)

2017-07-28T20:44:27-07:00

Edited by:

akashchandragupta

<h3>Content changes:</h3>

	Revision 1279023			Revision 1279025
t	19	border-bottom-left-radius: 20%; /* corner of a circle if box is a	t	19	border-bottom-left-radius: 20%; /* corner of a circle if box is a
	>	square or else corner of a rectangle */		>	square or else corner of a rectangle */
	20	border-bottom-left-radius: 20% 20%; /* same as above / / 20% of		20	border-bottom-left-radius: 20% 20%; /* same as above / / 20% of
	>	horizontal/width and 20% of vertical/height */		>	horizontal(width) and 20% of vertical(height) */
	21	border-bottom-left-radius: 20% 10%; /* 20% of horizontal/width an		21	border-bottom-left-radius: 20% 10%; /* 20% of horizontal(width) a
	>	d 10% of vertical/height */		>	nd 10% of vertical(height) */

Web/CSS/border-bottom-left-radius (en-US)

2017-07-28T20:46:26-07:00

Edited by:

akashchandragupta

<h3>Content changes:</h3>

	Revision 1279025			Revision 1279027
t	20	border-bottom-left-radius: 20% 20%; /* same as above / / 20% of	t	20	border-bottom-left-radius: 20% 20%; /* same as above / / 20% of
	>	horizontal(width) and 20% of vertical(height) */		>	horizontal(width) and vertical(height) */

Web/CSS/border-bottom-right-radius (en-US)

2017-07-28T21:08:01-07:00

Edited by:

akashchandragupta

<h3>Content changes:</h3>

+/* Percentage values */
+border-bottom-right-radius: 20%; /* corner of a circle if box is
+a square or else corner of a rectangle */
+border-bottom-right-radius: 20% 20%; /* same as above */ /* 20% o
+f horizontal(width) and vertical(height) */
+border-bottom-right-radius: 20% 10%; /* 20% of horizontal(width)
+and 10% of vertical(height) */

Web/API/HTMLTemplateElement/content (en-US)

2017-07-29T00:07:20-07:00

Edited by:

walterebert

Comment:

importNode only works on documents and requires an externalNode

Tag changes:

	Revision 1163936			Revision 1279033
t	1	"API" "HTML DOM" "HTMLTemplateElement" "Property" "Reference" "We	t	1	"API" "HTML DOM" "HTMLTemplateElement" "Property" "Reference" "We
	>	b Components" "Web Components"		>	b Components"

<h3>Content changes:</h3>

	Revision 1163936			Revision 1279033
t	24	var documentFragment = templateElement.content.importNode(true);	t	24	var documentFragment = templateElement.content.cloneNode(true);

Web/CSS/CSS_Grid_Layout (en-US)

2017-07-29T02:07:50-07:00

Edited by:

DanRickerby

Comment:

Changed order of properties for .three to make CSS more readable

<h3>Content changes:</h3>

Web/HTML/Element/tr (en-US)

2017-07-29T02:21:21-07:00

Edited by:

Martin.Kraft

<h3>Content changes:</h3>

	Revision 1242931			Revision 1279039
t	470	<li>the {{cssxref(":nth-child")}} pseudo-class to set t	t	470	<li>the {{cssxref(":nth-child")}} pseudo-class to set t
	>	he alignment on the cells of the column;		>	he alignment on the cells of the row or column;

Web/CSS/Reference (en-US)

2017-07-29T03:56:08-07:00

Edited by:

mfluehr

<h3>Content changes:</h3>

	Revision 1278869			Revision 1279043
t	20	Be warned that any syntax error in a rule definition will i	t	20	Be warned that any <a href="/en-US/docs/Web/CSS/syntax">syn
	>	nvalidate the entire rule.		>	tax</a> error in a rule definition will invalidate the entire rul
				>	e.

Web/CSS/border-bottom-right-radius (en-US)

2017-07-29T03:57:42-07:00

Edited by:

akashchandragupta

<h3>Content changes:</h3>

	Revision 1279029			Revision 1279045
n	14	/* the corner is a circle */	n	14	/* The corner is a circle */
t	23	/* the corner is an ellipsis */	t	23	/The corner is an ellipsis /

Web/HTTP/Basics_of_HTTP/MIME_types/Complete_list_of_MIME_types (en-US)

2017-07-29T04:04:56-07:00

Edited by:

NaveenDA

<h3>Content changes:</h3>

+            <code>.ts</code>
+          </td>
+          <td>
+            Typescript file
+          </td>
+          <td>
+            <code>video/vnd.dlna.mpeg-tts</code>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            application/vnd.mozilla.xul+xml

Web/JavaScript (en-US)

2017-07-29T05:03:24-07:00

Edited by:

wlwlz

Comment:

Revert to revision of 2017-05-31 02:37:02.837233 by ariyankhan: "The main site is using the wrong language."

<h3>Content changes:</h3>

	Revision 1278719			Revision 1279063
n	11	<strong>JavaScript</strong> (<strong>JS</strong>) is a ligh	n	11	<strong>JavaScript</strong> (<strong>JS</strong>) is a ligh
	>	tweight interpreted or JIT-compiled programming languag		>	tweight interpreted or JIT-compiled programming languag
	>	e with {{术语("First-class Function", "first-class functions")}}. W		>	e with {{Glossary("First-class Function", "first-class functions"
	>	hile it is most well-known as the scripting language for Web page		>	)}}. While it is most well-known as the scripting language for We
	>	s, <a class="external" href="https://en.wikipedia.org/wiki/JavaSc		>	b pages, <a class="external" href="https://en.wikipedia.org/wiki/
	>	ript#Uses_outside_Web_pages">many non-browser environments</a> al		>	JavaScript#Uses_outside_Web_pages">many non-browser environments<
	>	so use it, such as <a class="external" href="https://nodejs.org/"		>	/a> also use it, such as <a class="external" href="https://nodejs
	>	>node.js</a>, <a href="https://couchdb.apache.org/">Apache CouchD		>	.org/">node.js</a>, <a href="https://couchdb.apache.org/">Apache
	>	B</a> and <a href="http://www.adobe.com/devnet/acrobat/javascript		>	CouchDB</a> and <a href="http://www.adobe.com/devnet/acrobat/java
	>	.html">Adobe Acrobat</a>. JavaScript is a {{Glossary("Protot		>	script.html">Adobe Acrobat</a>. JavaScript is a {{Glossary("
	>	ype-based programming", "prototype-based")}}, multi-paradigm, dyn		>	Prototype-based programming", "prototype-based")}}, multi-paradig
	>	amic language, supporting object-oriented, imperative, and d		>	m, dynamic language, supporting object-oriented, imperative,
	>	eclarative (e.g. functional programming) styles. Read more <		>	and declarative (e.g. functional programming) styles. Read
	>	a href="/en-US/docs/Web/JavaScript/About_JavaScript">about JavaSc		>	more <a href="/en-US/docs/Web/JavaScript/About_JavaScript">about
	>	ript</a>.		>	JavaScript</a>.
	12	</p>
	13	<p>		12	</p>
	14
	15	</p>		13	<p>
				14	This section of the site is dedicated to the JavaScript lan
				>	guage itself, and not the parts that are specific to Web pages or
				>	other host environments. For information about {{Glossary("API",
				>	"APIs")}} specific to Web pages, please see <a href="/en-US/docs/
				>	Web/API">Web APIs</a> and <a href="/en-US/docs/Glossary/DOM">DOM<
				>	/a>.
	16	<p>		15	</p>
	17	该网站的此部分专用于JavaScript语言本身，而不是特定于Web页面或其他主机环境的部分。有关{{术语（“API”
	>	，“APIs”）}}的信息，请参阅<a href="/en-US/docs/Web/API">Web APIs</a>
	>	和 <a href="/en-US/docs/Glossary/DOM">DOM</a>.。
	18	</p>		16	<p>
				17	The standard for JavaScript is <a href="/en-US/docs/Web/Jav
				>	aScript/Language_Resources">ECMAScript</a>. As of 2012, all <a hr
				>	ef="https://kangax.github.io/compat-table/es5/">modern browsers</
				>	a> fully support ECMAScript 5.1. Older browsers support at least
				>	ECMAScript 3. On June 17, 2015, <a href="https://www.ecma-interna
				>	tional.org">ECMA International</a> published the sixth major vers
				>	ion of ECMAScript, which is officially called ECMAScript 2015, an
				>	d was initially referred to as ECMAScript 6 or ES6. Since then, E
				>	CMAScript standards are on yearly release cycles. This documentat
				>	ion refers to the latest draft version, which is currently <a hre
				>	f="https://tc39.github.io/ecma262/">ECMAScript 2018</a>.
	19	<p>		18	</p>
	20	JavaScript的规范是<a href="/en-US/docs/Web/JavaScript/Language_
	>	Resources">ECMAScript</a>. 2012年, 所有 <a href="https://kangax
	>	.github.io/compat-table/es5/">modern browsers</a> 都支持ECMAScr
	>	ipt 5.1. 较老的浏览器至少支持 ECMAScript 3. 在2015年6月17日, <a href="http
	>	s://www.ecma-international.org">ECMA International</a> 发布了EC
	>	MAScript的第六个主要版本,官方称其为ECMAScript 2015, 又称ECMAScript 6 或者ES6. 从那时起
	>	, ECMAScript 标准每年更新一次。本文档参考最新的草案，也就是现在的<a href="https://tc39.gith
	>	ub.io/ecma262/">ECMAScript 2018</a>.
	21	</p>		19	<p>
	22	<p>		20	Do not confuse JavaScript with the <a href="https://en.wiki
				>	pedia.org/wiki/Java_(programming_language)">Java programming lang
				>	uage</a>. Both "Java" and "JavaScript" are trademarks or register
				>	ed trademarks of Oracle in the U.S. and other countries. However,
				>	the two programming languages have very different syntax, semant
				>	ics, and uses.
	23	不要把javascript和<a href="https://en.wikipedia.org/wiki/Java_(
	>	programming_language)">Java programming language</a>.混淆。"Java" 和
	>	"JavaScript"是Oracle在美国和其他国家的商标或者注册商标。但是，两种编程语言有着不同的语法，语义和使用。
n	28	教程	n	25	Tutorials
n	31		n	28	Learn how to program in JavaScript with guides and tuto
				>	rials.
	32	</p>
	33	<p>
	34	了解如何使用指南和教程进行javascript编程
n	37	对于完全的新手	n	31	For complete beginners
n	42	<p>	n
	43
	44	</p>
	45	<p>
	46	如果您想学习JavaScript但没有JavaScript或编程的经验，请转到我们的学习区域JavaScrip
	>	t主题。可用的完整模块如下：
	47	</p>
n	53	回答一些基本问题，例如“什么是JavaScript”，“它是什么样子”，以及“它能做什么”，以及讨论关键的	n	41	Answers some fundamental questions such as "what is J
	>	JavaScript功能，如变量，字符串，数字和数组。		>	avaScript?", "what does it look like?", and "what can it do?", al
				>	ong with discussing key JavaScript features such as variables, st
				>	rings, numbers and arrays.
n	59	继续介绍JavaScript的关键基本特征，将注意力转移到常见的代码块类型，如条件语句，循环，函数和事件。	n	47	Continues our coverage of JavaScript's key fundamenta
				>	l features, turning our attention to commonly-encountered types o
				>	f code block such as conditional statements, loops, functions, an
				>	d events.
n	65	了解JavaScript的面向对象本质很重要，为了让您想进一步了解您的语言和编写更有效的代码，我们提供了此	n	53	The object-oriented nature of JavaScript is important
	>	模块来帮助您。		>	to understand if you want to go further with your knowledge of t
				>	he language and write more efficient code, therefore we've provid
				>	ed this module to help you.
n	69	JavaScript指南	n	57	JavaScript guide
n	76	更详细的JavaScript语言指南，针对具有JavaScript或其他语言的以前编程经验的人员。	n	64	A much more detailed guide to the JavaScript language
				>	, aimed at those with previous programming experience either in J
				>	avaScript or another language.
t	142	参考	t	130	Reference

Web/HTTP (en-US)

2017-07-29T05:38:42-07:00

Edited by:

kaipoeritz

<h3>Content changes:</h3>

	Revision 1187221			Revision 1279067
t	11	<span class="seoSummary"><strong><dfn>Hypertext Transfer Pr	t	11	<span class="seoSummary"><strong><dfn>Hypertext Transfer Pr
	>	otocol (HTTP)</dfn></strong> is an <a class="external" href="http		>	otocol (HTTP)</dfn></strong> is an <a class="external" href="http
	>	s://en.wikipedia.org/wiki/Application_Layer">application-layer</a		>	s://en.wikipedia.org/wiki/Application_Layer">application-layer</a
	>	> protocol for transmitting hypermedia documents, such as HTML.</		>	> protocol for transmitting hypermedia documents, such as HTML.</
	>	span> It was designed for communication between web browsers and		>	span> It was designed for communication between web browsers and
	>	web servers, but it can also be used for other purposes. HTTP fol		>	web servers, but it can also be used for other purposes. HTTP fol
	>	lows a classical <a class="external" href="https://en.wikipedia.o		>	lows a classical <a class="external" href="https://en.wikipedia.o
	>	rg/wiki/Client%E2%80%93server_model">client-server model</a>, wit		>	rg/wiki/Client%E2%80%93server_model">client-server model</a>, wit
	>	h a client opening a connection to make a request, then waiting u		>	h a client opening a connection to make a request, then waiting u
	>	ntil it receives a response. HTTP is a <a class="external" href="		>	ntil it receives a response. HTTP is a <a class="external" href="
	>	https://en.wikipedia.org/wiki/Stateless_protocol">stateless proto		>	https://en.wikipedia.org/wiki/Stateless_protocol">stateless proto
	>	col</a>, meaning that the server does not keep any data (state) b		>	col</a>, meaning that the server does not keep any data (state) b
	>	etween two requests. Though often based on a TCP/IP layer, it can		>	etween two requests. Though often based on a TCP/IP layer, it can
	>	be used on any reliable <a class="external" href="http://en.wiki		>	be used on any unreliable <a class="external" href="http://en.wi
	>	pedia.org/wiki/Transport_Layer">transport layer</a>; that is, a p		>	kipedia.org/wiki/Transport_Layer">transport layer</a>; that is, a
	>	rotocol that doesn't lose messages silently, such as UDP.		>	protocol that does lose messages silently, such as UDP.

Web/JavaScript/Reference/Classes/constructor (en-US)

2017-07-29T06:55:41-07:00

Edited by:

heisenbugger

Comment:

Fix formatting

<h3>Content changes:</h3>

	Revision 1267093			Revision 1279087
n	66	<pre class="brush: js" style="background-color:#ffffff;color:	n	66	<pre class="brush: js">
	>	#000000;font-family:'DejaVu Sans Mono';font-size:9.0pt;">
	67	<strong style="color:#000080; font-weight:bold">class </strong><s		67	class Polygon {
	>	pan style="background-color:#e4e4ff">Polygon</span> {
	68	<span style="color:#7a7a43">constructor</span>() {		68	constructor() {
	69	<strong style="color:#000080; font-weight:bold">this</str		69	this.name = "Polygon";
	>	ong>.<strong style="color:#660e7a; font-weight:bold">name </stron
	>	g>= <strong style="color:#008000; font-weight:bold">"</strong><st
	>	rong style="background-color:#e4e4ff; color:#008000; font-weight:
	>	bold">Polygon</strong><strong style="color:#008000; font-weight:b
	>	old">"</strong>;
n	73	<strong style="color:#000080; font-weight:bold">class </strong>Sq	n	73	class Square extends Polygon {
	>	uare <strong style="color:#000080; font-weight:bold">extends </st
	>	rong><span style="background-color:#e4e4ff">Polygon</span> {
	74	<span style="color:#7a7a43">constructor</span>() {		74	constructor() {
	75	<strong style="color:#000080; font-weight:bold">super</st		75	super();
	>	rong>();
n	79	<strong style="color:#000080; font-weight:bold">class </strong>Re	n	79	class Rectangle {}
	>	ctangle {}
n	81	Object.<span style="color:#7a7a43">setPrototypeOf</span>(Square.<	n	81	Object.setPrototypeOf(Square.prototype, Rectangle.prototype);
	>	strong style="color:#660e7a; font-weight:bold">prototype</strong>
	>	, Rectangle.<strong style="color:#660e7a; font-weight:bold">proto
	>	type</strong>);
n	83	<em style="color:#660e7a; font-style:italic; font-weight:bold">co	n	83	console.log(Object.getPrototypeOf(Square.prototype) === Polygon.p
	>	nsole</em>.<span style="color:#7a7a43">log</span>(Object.<span st		>	rototype); //false
	>	yle="color:#7a7a43">getPrototypeOf</span>(Square.<strong style="c
	>	olor:#660e7a; font-weight:bold">prototype</strong>) === <span sty
	>	le="background-color:#e4e4ff">Polygon</span>.<strong style="color
	>	:#660e7a; font-weight:bold">prototype</strong>); <em style="color
	>	:#808080; font-style:italic">//false
	84	</em><em style="color:#660e7a; font-style:italic; font-weight:bol		84	console.log(Object.getPrototypeOf(Square.prototype) === Rectangle
	>	d">console</em>.<span style="color:#7a7a43">log</span>(Object.<sp		>	.prototype); //true
	>	an style="color:#7a7a43">getPrototypeOf</span>(Square.<strong sty
	>	le="color:#660e7a; font-weight:bold">prototype</strong>) === Rect
	>	angle.<strong style="color:#660e7a; font-weight:bold">prototype</
	>	strong>); <em style="color:#808080; font-style:italic">//true
t	86	</em><strong style="color:#000080; font-weight:bold">let </strong	t	86	let newInstance = new Square();
	>	><em style="color:#660e7a; font-style:italic; font-weight:bold">n
	>	ewInstance </em>= <strong style="color:#000080; font-weight:bold"
	>	>new </strong>Square();<em style="color:#808080; font-style:itali
	>	c">
	87	</em><em style="color:#660e7a; font-style:italic; font-weight:bol		87	console.log(newInstance.name); //Polygon
	>	d">console</em>.<span style="color:#7a7a43">log</span>(<em style=
	>	"color:#660e7a; font-style:italic; font-weight:bold">newInstance<
	>	/em>.<strong style="color:#660e7a; font-weight:bold">name</strong
	>	>); <em style="color:#808080; font-style:italic">//Polygon</em>

Web/JavaScript/Reference (en-US)

2017-07-29T07:24:09-07:00

Edited by:

vanessadacosta

<h3>Content changes:</h3>

+    <p>
+    </p>
+      Esta parte da seção de JavaScript no MDN serve como um repo
->
+sitório de fatos sobre o idioma JavaScript. Leia mais <a href="/e
->
+n-US/docs/Web/JavaScript/Reference/About">sobre esta referência</
->
+a>.
+      Objetos globais &lt;/ h2&gt;
+      Este capítulo documenta todos os <a href="/en-US/docs/Web/J
->
+avaScript/Reference/Global_Objects">objetos embutidos padrão de J
->
+avaScript</a> , juntamente com seus métodos e propriedades. &lt;/
+ P &gt;
+      {{page ('/ en-US / docs / Web / JavaScript / Reference / Gl
->
+obal_Objects', 'Standard_objects_by_category')}} &lt;/ div&gt;
+      <h2 id="Declarações">
+        Declarações &lt;/ h2&gt;
+      </h2>
+      <p>
+        Este capítulo documenta todas as <a href="/en-US/docs/Web
+/JavaScript/Reference/Statements">declarações e declarações de Ja
+vaScript</a> . &lt;/ P&gt;
+      </p>
+      <div>
+        {{page ('/ en-US / docs / Web / JavaScript / Reference /
+Statements', 'Statements_and_declarations_by_category')}} &lt;/ d
+iv&gt;
+        <h2 id="Expressions_and_operators">
+          Expressões e operadores &lt;/ h2&gt;
+        </h2>
+        <p>
+          Este capítulo documenta todas as <a href="/en-US/docs/W
+eb/JavaScript/Reference/Operators">expressões e operadores de Jav
+aScript</a> . &lt;/ P&gt;
+        </p>
+        <div>
+          {{page ('/ en-US / docs / Web / JavaScript / Referência
+ / Operadores', 'Expressions_and_operators_by_category')}} &lt;/
+div&gt;
+          <h2 id="Funções">
+            Funções &lt;/ h2&gt;
+          </h2>
+          <p>
+            Este capítulo documenta como trabalhar com <a href="/
+en-US/docs/Web/JavaScript/Reference/Functions">funções de JavaScr
+ipt</a> para desenvolver seus aplicativos. &lt;/ P&gt;
+          </p>
+          <ul>
+            <li>
+              <a href="/en-US/docs/Web/JavaScript/Reference/Funct
+ions/arguments"><code>argumentos &lt;/ code&gt;</code></a> &lt;/
+li&gt;
+            </li>
+            <li>
+              <a href="/en-US/docs/Web/JavaScript/Reference/Funct
+ions/Arrow_functions">Funções de seta</a> &lt;/ li&gt;
+            </li>
+            <li>
+              <a href="/en-US/docs/Web/JavaScript/Reference/Funct
+ions/Default_parameters">Parâmetros padrão</a> &lt;/ li&gt;
+            </li>
+            <li>
+              <a href="/en-US/docs/Web/JavaScript/Reference/Funct
+ions/rest_parameters">Parâmetros de descanso</a> &lt;/ li&gt; &lt
+;/ Ul&gt;
+              <h2 id="Additional_reference_pages">
+                Páginas de referência adicionais &lt;/ h2&gt;
+              </h2>
+              <ul>
+                <li>
+                  <a href="/en-US/docs/Web/JavaScript/Reference/L
+exical_grammar">Gramática lexica</a> &lt;/ li&gt;
+                </li>
+                <li>
+                  <a href="/en-US/docs/Web/JavaScript/Data_struct
+ures">Tipos de dados e estruturas de dados</a> &lt;/ li&gt;
+                </li>
+                <li>
+                  <a href="/en-US/docs/Web/JavaScript/Reference/S
+trict_mode">Modo estrito</a> &lt;/ li&gt;
+                </li>
+                <li>
+                  <a href="/en-US/docs/Web/JavaScript/Reference/D
+eprecated_and_obsolete_features">Recursos desaprovados</a> &lt;/
+li&gt; &lt;/ Ul&gt;
+                </li>
+              </ul>
+            </li>
+          </ul>
+        </div>
+      </div>
->
->
->
->
->
->
->
->
->
->
->
->
->
->
->
->

Web (en-US)

2017-07-29T07:58:59-07:00

Edited by:

vanessadacosta

<h3>Content changes:</h3>

+    <div class="note">
+      <p class="summary" data-fulltext="" data-placeholder="Tradu
->
+ção" dir="ltr" id="tw-target-text" style="text-align: left; heigh
->
+t: 192px;">
->
->
+        <strong><span lang="pt">A natureza aberta da World Wide W
+eb apresenta oportunidades incríveis para pessoas que desejam cri
+ar sites ou aplicativos online. Para aproveitar ao máximo os recu
+rsos da web, você precisa saber como usá-los. Explore os links ab
+aixo para saber mais sobre várias tecnologias da web.</span></str
+ong>
+      </p>
+    </div>
+        <p class="summary" data-fulltext="" data-placeholder="Tra
+dução" dir="ltr" style="text-align: left; height: 36px;">
+          <span lang="pt">Tecnologias da Web</span>
+        </p>
+        <div class="note">
+          <p class="summary" data-fulltext="" data-placeholder="T
+radução" dir="ltr" style="text-align: left; height: 288px;">
+            <span lang="pt">Noções básicas</span>
+          </p>
+          <p class="summary" data-fulltext="" data-placeholder="T
+radução" dir="ltr" style="text-align: left; height: 288px;">
+            HTML<br>
+            &nbsp;&nbsp;&nbsp; O HyperText Markup Language (HTML)
+ é usado para descrever e definir o conteúdo de uma página da Web
+.<br>
+            CSS<br>
+            &nbsp;&nbsp;&nbsp; Folhas de estilo em cascata (CSS)
+são usadas para descrever a aparência ou apresentação de conteúdo
+ em uma página da Web.
+          </p>
+        </div>
+            <br class="summary" data-fulltext="" data-placeholder
+="Tradução" dir="ltr" style="text-align: left; height: 120px;">
+            <span lang="pt">HTTP<br>
+            &nbsp;&nbsp;&nbsp; Protocolo de transferência de hipe
+rtexto (HTTP) é usado para entregar HTML e outros documentos hipe
+rmídia na web.</span><br>
+            <br>
+          </dt>
+        </dl>
+        <pre class="syntaxbox" data-fulltext="" data-placeholder=
+"Tradução" dir="ltr" style="text-align: left; height: 768px;">
+<span class="seoSummary"><span lang="pt">Scripts</span></span>
+</pre>
+        <p class="summary" data-fulltext="" data-placeholder="Tra
+dução" dir="ltr" style="text-align: left; height: 768px;">
+          JavaScript<br>
+          &nbsp;&nbsp;&nbsp;&nbsp;JavaScript é a linguagem de pro
+gramação que é executada no seu navegador. Você pode usá-lo para
+adicionar interatividade e outros recursos dinâmicos ao seu site
+ou aplicativo.<br>
+          API da Web<br>
+          &nbsp;&nbsp;&nbsp;&nbsp;Interfaces de programação de ap
+licativos da Web (APIs da Web) são usadas para executar uma varie
+dade de tarefas, como a manipulação de DOM, reprodução de áudio o
+u vídeo ou geração de gráficos 3D.
+        </p>
+        <p class="summary" data-fulltext="" data-placeholder="Tra
+dução" dir="ltr" style="text-align: left; height: 768px;">
+          &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;A refer
+ência de interface da API da Web lista todos os tipos de objeto q
+ue você pode usar enquanto se desenvolve para a web.<br>
+          &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;A págin
+a WebAPI lista todas as comunicações, acesso de hardware e outras
+ APIs que você pode usar em aplicativos da web.<br>
+          &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;A refer
+ência do Evento lista todos os eventos que você pode usar para ra
+strear e reagir a coisas interessantes que ocorreram em sua págin
+a ou aplicativo.
+        </p>
+        <p class="summary" data-fulltext="" data-placeholder="Tra
+dução" dir="ltr" style="text-align: left; height: 768px;">
+          Gráficos
+        </p>
+        <dl>
+          <dt>
+            <br class="summary" data-fulltext="" data-placeholder
+="Tradução" dir="ltr" style="text-align: left; height: 1056px;">
+            <span lang="pt">SVG<br>
+            &nbsp;&nbsp;&nbsp;&nbsp;Scalable Vector Graphics (SVG
+) permite que você descreva imagens como conjuntos de vetores (li
+nhas) e formas. Uma vantagem de SVGs é que eles escalam sem probl
+emas, independentemente do tamanho em que são desenhados.<br>
+            WebGL<br>
+            &nbsp;&nbsp;&nbsp;&nbsp;WebGL é uma API de JavaScript
+ que permite desenhar gráficos 3D ou 2D usando o elemento HTML {{
+HTMLElement ("canvas")}}.</span><br>
+            <br>
+            <br class="summary" data-fulltext="" data-placeholder
+="Tradução" dir="ltr" style="text-align: left; height: 1056px;">
+            Áudio, vídeo e multimídia<br>
+            <br>
+            <br class="summary" data-fulltext="" data-placeholder
+="Tradução" dir="ltr" style="text-align: left; height: 1056px;">
+            Tecnologias de mídia na web<br>
+            &nbsp;&nbsp;&nbsp;&nbsp;Uma lista de APIs relacionada
+s à mídia com links para a documentação que você precisa para cad
+a uma.<br>
+            Visão geral da tecnologia de mídia na web<br>
+            &nbsp;&nbsp;&nbsp;&nbsp;Uma visão geral das tecnologi
+as da Web abertas e das APIs que oferecem suporte para reprodução
+, manipulação e gravação de áudio e vídeo. Se você não tem certez
+a sobre qual API você deve usar, este é o lugar para começar.<br>
+            API de captura e transmissão de mídia<br>
+            &nbsp;&nbsp;&nbsp;&nbsp;Uma referência para a API que
+ permite transmitir, gravar e manipular mídia tanto local quanto
+em uma rede. Isso inclui o uso de câmeras e microfones locais par
+a capturar imagens de vídeo, áudio e imagens estáticas.<br>
+            <br>
+            <h4 class="tw-data-text tw-ta tw-text-small" data-ful
->
+ltext="" data-placeholder="Tradução" dir="ltr" style="text-align:
+ left; height: 1056px;">
+              De outros
->
->
->
->
->
->
->
->
->
+            </h4>
+            <p class="summary" data-fulltext="" data-placeholder=
->
+"Tradução" dir="ltr" style="text-align: left; height: 1056px;">
->
+              MathML<br>
+              &nbsp;&nbsp;&nbsp;&nbsp;Mathematical Markup Languag
->
+e (MathML) permite exibir equações matemáticas complexas e sintax
->
+e.
->
->
->
+            </p>
->
->
->
->
->
->
->
->
->
->
->
->
->
->
->
->
->
->
+      <div>
+        <p class="summary" data-fulltext="" data-placeholder="Tra
+dução" dir="ltr">
+          Área de aprendizagem
+        </p>
+        <p class="summary" data-fulltext="" data-placeholder="Tra
+dução" dir="ltr">
+          Aprendendo desenvolvimento web<br>
+          &nbsp;&nbsp;&nbsp;&nbsp;Este conjunto de artigos fornec
+e aos iniciantes tudo o que eles precisam para começar a codifica
+r sites simples.
+        </p>
+        <h4>
+          &nbsp;
+        </h4>
+        <p class="summary">
+          Other topics
+        </p>
->
+            <h4>
->
+              &nbsp;
+            </h4>
+            <p class="summary" data-fulltext="" data-placeholder=
+"Tradução" dir="ltr">
+              Desenvolvendo aplicativos da web<br>
+              &nbsp;&nbsp;&nbsp;&nbsp;Este conjunto de artigos ex
+plica as técnicas utilizadas no desenvolvimento de aplicativos da
+ web para ambientes móveis, de desktop e de SO Firefox.<br>
+              Acessibilidade<br>
+              &nbsp;&nbsp;&nbsp;&nbsp;Os sites acessíveis permite
+m o maior número possível de pessoas para usar a web, incluindo a
+queles cujas habilidades visuais, auditivas ou outras sejam limit
+adas de alguma forma. Este conjunto de artigos fornece informaçõe
+s sobre desenvolvimento web acessível.<br>
+              Segurança<br>
+              &nbsp;&nbsp;&nbsp;&nbsp;Não deixe o seu site ou apl
+icativo filtrar dados privados para os bandidos. Use este conjunt
+o de artigos para garantir que seus projetos estejam seguros.
+            </p>
->
+            <h4>
->
->
+              &nbsp;
+            </h4>
->
->
->
->
->
->
+    <h4>
+    </h4>

Web (en-US)

2017-07-29T08:16:17-07:00

Edited by:

vanessadacosta

<h3>Content changes:</h3>

	Revision 1279101			Revision 1279103
n			n	7	<div class="warning">
	7	<div class="note">		8	<div class="note">
	8	<p class="summary" data-fulltext="" data-placeholder="Tradu		9	<h2 class="summary" data-fulltext="" data-placeholder="Tr
	>	ção" dir="ltr" id="tw-target-text" style="text-align: left; heigh		>	adução" dir="ltr" id="tw-target-text" style="text-align: left; he
	>	t: 192px;">		>	ight: 192px;">
	9	<strong><span lang="pt">A natureza aberta da World Wide W		10	<strong><span lang="pt">A natureza aberta da World Wide
	>	eb apresenta oportunidades incríveis para pessoas que desejam cri		>	Web apresenta oportunidades incríveis para pessoas que desejam c
	>	ar sites ou aplicativos online. Para aproveitar ao máximo os recu		>	riar sites ou aplicativos online. Para aproveitar ao máximo os re
	>	rsos da web, você precisa saber como usá-los. Explore os links ab		>	cursos da web, você precisa saber como usá-los. Explore os links
	>	aixo para saber mais sobre várias tecnologias da web.</span></str		>	abaixo para saber mais sobre várias tecnologias da web.</span></s
	>	ong>		>	trong>
				11	</h2>
	10	</p>		12	</div>
n	54	<dt>	n
	55	<br class="summary" data-fulltext="" data-placeholder
	>	="Tradução" dir="ltr" style="text-align: left; height: 1056px;">
	56	<span lang="pt">SVG<br>
	57	Scalable Vector Graphics (SVG
	>	) permite que você descreva imagens como conjuntos de vetores (li
	>	nhas) e formas. Uma vantagem de SVGs é que eles escalam sem probl
	>	emas, independentemente do tamanho em que são desenhados.<br>
	58	WebGL<br>
	59	WebGL é uma API de JavaScript
	>	que permite desenhar gráficos 3D ou 2D usando o elemento HTML {{
	>	HTMLElement ("canvas")}}.</span><br>
	60	<br>
	61	<br class="summary" data-fulltext="" data-placeholder
	>	="Tradução" dir="ltr" style="text-align: left; height: 1056px;">
	62	Áudio, vídeo e multimídia<br>
	63	<br>
	64	<br class="summary" data-fulltext="" data-placeholder
	>	="Tradução" dir="ltr" style="text-align: left; height: 1056px;">
	65	Tecnologias de mídia na web<br>
	66	Uma lista de APIs relacionada
	>	s à mídia com links para a documentação que você precisa para cad
	>	a uma.<br>
	67	Visão geral da tecnologia de mídia na web<br>
	68	Uma visão geral das tecnologi
	>	as da Web abertas e das APIs que oferecem suporte para reprodução
	>	, manipulação e gravação de áudio e vídeo. Se você não tem certez
	>	a sobre qual API você deve usar, este é o lugar para começar.<br>
	69	API de captura e transmissão de mídia<br>
	70	Uma referência para a API que
	>	permite transmitir, gravar e manipular mídia tanto local quanto
	>	em uma rede. Isso inclui o uso de câmeras e microfones locais par
	>	a capturar imagens de vídeo, áudio e imagens estáticas.<br>
	71	<br>
	72	</dt>
n			n	57	<h2 class="summary" data-fulltext="" data-placeholder
				>	="Tradução" dir="ltr" style="text-align: left; height: 1056px;">
				58	<span lang="pt">SVG<br>
				59	Scalable Vector Graphics (S
				>	VG) permite que você descreva imagens como conjuntos de vetores (
				>	linhas) e formas. Uma vantagem de SVGs é que eles escalam sem pro
				>	blemas, independentemente do tamanho em que são desenhados.<br>
				60	WebGL<br>
				61	WebGL é uma API de JavaScri
				>	pt que permite desenhar gráficos 3D ou 2D usando o elemento HTML
				>	{{HTMLElement ("canvas")}}.</span>
				62	</h2>
				63	<p class="summary" data-fulltext="" data-placeholder=
				>	"Tradução" dir="ltr" style="text-align: left; height: 1056px;">
				64	Áudio, vídeo e multimídia
				65	</p>
				66	<p class="summary" data-fulltext="" data-placeholder=
				>	"Tradução" dir="ltr" style="text-align: left; height: 1056px;">
				67	Tecnologias de mídia na web<br>
				68	Uma lista de APIs relaciona
				>	das à mídia com links para a documentação que você precisa para c
				>	ada uma.<br>
				69	Visão geral da tecnologia de mídia na web<br>
				70	Uma visão geral das tecnolo
				>	gias da Web abertas e das APIs que oferecem suporte para reproduç
				>	ão, manipulação e gravação de áudio e vídeo. Se você não tem cert
				>	eza sobre qual API você deve usar, este é o lugar para começar.<b
				>	r>
				71	API de captura e transmissão de mídia<br>
				72	Uma referência para a API q
				>	ue permite transmitir, gravar e manipular mídia tanto local quant
				>	o em uma rede. Isso inclui o uso de câmeras e microfones locais p
				>	ara capturar imagens de vídeo, áudio e imagens estáticas.
				73	</p>
t	95	<p class="summary">	t	95	<pre class="tw-data-text tw-ta tw-text-medium" data-fullt
				>	ext="" data-placeholder="Tradução" dir="ltr" id="tw-target-text"
				>	style="text-align: left; height: 36px;">
	96	Other topics		96	<span lang="pt">Outros tópicos</span>
	97	</p>		97	</pre>

Web/API/Element/classList (en-US)

2017-07-29T10:12:38-07:00

Edited by:

erosman

Comment:

Added note to remove (source https://www.w3schools.com/jsref/prop_element_classlist.asp )

<h3>Content changes:</h3>

	Revision 1277523			Revision 1279129
t	39	Remove specified class values.	t	39	Remove specified class values.<br>
				40	<strong>Note:</strong> Removing a class that does not exi
				>	st, does NOT throw an error

Web/API/Element/classList (en-US)

2017-07-29T10:13:43-07:00

Edited by:

erosman

<h3>Content changes:</h3>

	Revision 1279129			Revision 1279131
t	40	<strong>Note:</strong> Removing a class that does not exi	t	40	<strong>Note:</strong> Removing a class that does not exi
	>	st, does NOT throw an error		>	st, does NOT throw an error.

Learn/Server-side/Express_Nodejs/mongoose (en-US)

2017-07-29T10:29:20-07:00

Edited by:

crashuniverse

<h3>Content changes:</h3>

	Revision 1270229			Revision 1279133
t	247	a_string : String,	t	247	a_string: String,
	248	a_date : Date		248	a_date: Date

Web/HTTP/Headers/Content-Encoding (en-US)

2017-07-29T11:11:08-07:00

Edited by:

danielbankhead

Comment:

Per RFC 14.11, Content-Encoding may be a list

<h3>Content changes:</h3>

	Revision 1254727			Revision 1279145
n	11	The <strong><code>Content-Encoding</code></strong> entity h	n	11	The <strong><code>Content-Encoding</code></strong> entity h
	>	eader is used to compress the media-type. When present, its value		>	eader is used to compress the media-type. When present, its value
	>	indicates what additional content encoding has been applied to t		>	indicates which encodings were applied to th
	>	he entity-body. It lets the client know, how to decode in order t		>	e entity-body. It lets the client know, how to decode in order to
	>	o obtain the media-type referenced by the <code>Content-Type</cod		>	obtain the media-type referenced by the <code>Content-Type</code
	>	e> header.		>	> header.
t			t	45
				46	// Multiple, in the order in which they were applied
				47	Content-Encoding: gzip, identity
				48	Content-Encoding: deflate, gzip

Web/API/EventTarget/addEventListener (en-US)

2017-07-29T11:54:34-07:00

Edited by:

johnjago

Review changes:

<h3>Content changes:</h3>

	Revision 1277553			Revision 1279157
n	11	The <code><strong>EventTarget.addEventListener()</strong></	n	11	The <code><strong>EventTarget.addEventListener()</strong></
	>	code> method adds the specified {{domxref("EventListener")}}-comp		>	code> method adds the specified {{domxref("EventListener")}}-comp
	>	atible object to the list of event listeners for the specified ev		>	atible object to the list of event listeners for the specified ev
	>	ent type on the {{domxref("EventTarget")}} on which it's called.		>	ent type on the {{domxref("EventTarget")}} on which it is called.
	>	The event target may be an {{domxref("Element")}} in a document,		>	The event target may be an {{domxref("Element")}} in a document,
	>	the {{domxref("Document")}} itself, a {{domxref("Window")}}, or a		>	the {{domxref("Document")}} itself, a {{domxref("Window")}}, or
	>	ny other object that supports events (such as <code><a href="/en-		>	any other object that supports events (such as <code><a href="/en
	>	US/docs/DOM/XMLHttpRequest">XMLHttpRequest</a></code>).		>	-US/docs/DOM/XMLHttpRequest">XMLHttpRequest</a></code>).
n	29	A string representing the <a href="/en-US/docs/Web/Events	n	29	A string representing the <a href="/en-US/docs/Web/Events
	>	">event type</a> to listen out for.		>	">event type</a> to listen for.
n	52	<li>{{non-standard_inline}} <code>mozSystemGroup</code>	n	52	<li>{{non-standard_inline}} <code>mozSystemGroup</code>
	>	: Available only in code running in XBL, or in Firefox's chrome,		>	: A {{jsxref("Boolean")}} indicating that the listener should be
	>	it is a {{jsxref("Boolean")}} defining if the listener is added t		>	added to the system group. Available only in code running in XBL
	>	o the system group.		>	or in Firefox's chrome.
n	60	A {{jsxref("Boolean")}} which indicates that events	n	60	A {{jsxref("Boolean")}} indicating that events of th
	>	of this type will be dispatched to the registered <code>listener,		>	is type will be dispatched to the registered <code>listener</code
	>	</code> before being dispatched to any <code>EventTarget</code> b		>	> before being dispatched to any <code>EventTarget</code> beneath
	>	eneath it in the DOM tree. Events that are bubbling upward t		>	it in the DOM tree. Events that are bubbling upward through
	>	hrough the tree will not trigger a listener designated to use cap		>	the tree will not trigger a listener designated to use capture.
	>	ture. Event bubbling and capturing are two ways of propagating ev		>	Event bubbling and capturing are two ways of propagating events w
	>	ents which occur in an element that is nested within another		>	hich occur in an element that is nested within another eleme
	>	element, when both elements have registered a handle for that ev		>	nt, when both elements have registered a handle for that event. T
	>	ent. The event propagation mode determines the order in which ele		>	he event propagation mode determines the order in which elements
	>	ments receive the event. See <a href="http://www.w3.org/TR/D		>	receive the event. See <a href="http://www.w3.org/TR/DOM-Lev
	>	OM-Level-3-Events/#event-flow">DOM Level 3 Events</a> and <a		>	el-3-Events/#event-flow">DOM Level 3 Events</a> and <a href=
	>	href="http://www.quirksmode.org/js/events_order.html#link4">Java		>	"http://www.quirksmode.org/js/events_order.html#link4">JavaScript
	>	Script Event order</a> for a detailed explanation. If not sp		>	Event order</a> for a detailed explanation. If not specifie
	>	ecified, <code>useCapture</code> defaults to <code>false</code>.		>	d, <code>useCapture</code> defaults to <code>false</code>.
				61	</dd>
				62	<dd>
n	62	<strong>Note:</strong> For event listeners attached to	n	64	<strong>Note:</strong> For event listeners attached to
	>	the event target; the event is in the target phase, rather than c		>	the event target, the event is in the target phase, rather than t
	>	apturing and bubbling phases. Events in the target phase will tri		>	he capturing and bubbling phases. Events in the target phase will
	>	gger all listeners on an element in order they were registered, r		>	trigger all listeners on an element in the order they were regis
	>	egardless of the <code>useCapture</code> parameter.		>	tered, regardless of the <code>useCapture</code> parameter.
n	65	<strong>Note:</strong> <code>useCapture</code> has not	n	67	<strong>Note:</strong> <code>useCapture</code> has not
	>	always been optional. Ideally, you should include it for the broa		>	always been optional. Ideally, you should include it for the wide
	>	dest possible browser compatibility.		>	st possible browser compatibility.
n	72	A Firefox (Gecko)-specific parameter; if <code>true</code	n	74	A Firefox (Gecko)-specific parameter. If <code>true</code
	>	>, the listener receives synthetic events dispatched by web conte		>	>, the listener receives synthetic events dispatched by web conte
	>	nt (the default is <code>false</code> for chrome and <code>true</		>	nt (the default is <code>false</code> for chrome and <code>true</
	>	code> for regular web pages). This parameter is useful for code f		>	code> for regular web pages). This parameter is useful for code f
	>	ound in add-ons as well as the browser itself. See <a href="/en-U		>	ound in add-ons as well as the browser itself. See <a href="/en-U
	>	S/docs/Code_snippets/Interaction_between_privileged_and_non-privi		>	S/docs/Code_snippets/Interaction_between_privileged_and_non-privi
	>	leged_pages">Interaction between privileged and non-privileged pa		>	leged_pages">Interaction between privileged and non-privileged pa
	>	ges</a> for an example.		>	ges</a> for an example.
n	76	Before using a particular value in the <code>options</code>	n	78	Before using a particular value in the <code>options</code>
	>	object, it's a good idea to ensure that the user's browser suppo		>	object, it's a good idea to ensure that the user's browser suppo
	>	rts it, since these are a newer addition that not all browsers ha		>	rts it, since these are an addition that not all browsers have su
	>	ve supported historically. See {{anch("Safely detecting option su		>	pported historically. See {{anch("Safely detecting option support
	>	pport")}} for details.		>	")}} for details.
n	85	Because older browsers (as well as some not-too-old browser	n	87	Because older browsers (as well as some not-too-old browser
	>	s) are still out there which assume the third parameter is a Bool		>	s) still assume the third parameter is a Boolean, you need to bui
	>	ean, you need to build your code to handle this scenario intellig		>	ld your code to handle this scenario intelligently. You can do th
	>	ently. You can do this by using feature detection for each of the		>	is by using feature detection for each of the options you're inte
	>	options you're interested in.		>	rested in.
n	107	You can check whether any option is supported this way. Jus	n	109	You can check whether any option is supported this way. Jus
	>	t add a getter for that option using code like what's shown above		>	t add a getter for that option using code similar to what is show
	>	.		>	n above.
n	194	{{EmbedLiveSample('Event_Listener_with_anonymous_function')	n	196	{{EmbedLiveSample('Event_listener_with_anonymous_function')
	>	}}		>	}}
n	208	<li>It gives you finer-grained control of the phase when th	n	210	<li>It gives you finer-grained control of the phase when th
	>	e listener gets activated (capturing vs. bubbling).		>	e listener is activated (capturing vs. bubbling).
n	238	If an event attribute (e.g., <code>onclick</code>) is	n	240	If an event attribute (for example, <code>onclick</code>) i
	>	specified on an element in the HTML source, the JavaScript code i		>	s specified on an element in the HTML source, the JavaScript
	>	n the attribute value is effectively wrapped in a handler functio		>	code in the attribute value is effectively wrapped in a handler
	>	n which binds the value of <code>this</code> in a manner con		>	function which binds the value of <code>this</code> in a man
	>	sistent with the <code>addEventListener()</code>; an occurrence o		>	ner consistent with the <code>addEventListener()</code>; an occur
	>	f <code>this</code> within the code represents a refere		>	rence of <code>this</code> within the code represents a
	>	nce to the element. Note that the value of <code>this</code> insi		>	reference to the element. Note that the value of <code>this</cod
	>	de a function, <em>called by </em>the code in the attribute		>	e> inside a function, <em>called by </em>the code in the att
	>	value, behaves as per <a href="/en-US/docs/Web/JavaScript/Referen		>	ribute value, behaves as per <a href="/en-US/docs/Web/JavaScript/
	>	ce/Operators/this">standard rules</a>. Shown in the following exa		>	Reference/Operators/this">standard rules</a>. This is shown in th
	>	mple:		>	e following example:
n	248	<strong>Note:</strong> JavaScript 1.8.5 introduces the <cod	n	250	<strong>Note:</strong> JavaScript 1.8.5 introduces the <cod
	>	e><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Functi		>	e><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Functi
	>	on/bind">Function.prototype.bind()</a></code> method, which		>	on/bind">Function.prototype.bind()</a></code> method, which
	>	lets you specify the value that should be used as <code>this</cod		>	lets you specify the value that should be used as <code>this</cod
	>	e> for all calls to a given function. This method lets you easily		>	e> for all calls to a given function. This method lets you easily
	>	bypass problems where it's unclear what this will be, depending		>	bypass problems where it's unclear what this will be, depending
	>	on the context from which your function was called. Note, however		>	on the context from which your function was called. Note, however
	>	, that you'll need to keep a reference to the listener around so		>	, that you'll need to keep a reference to the listener around so
	>	you can later remove it.		>	you can remove it later.
n	298	Another way of handling the reference to <em>this,</em> is	n	300	Another way of handling the reference to <em>this</em> is t
	>	to pass to the EventListener a function, calling the method		>	o pass to the EventListener a function that calls the method
	>	of the object which fields want to be accessed:		>	of the object which contains the fields that need to be accessed
				>	:
n	353	<strong>Note:</strong> useCapture is not supported, as IE	n	355	<strong>Note:</strong> useCapture is not supported, as IE
	>	8 does not have any alternative method of it. Please also note t		>	8 does not have any alternative method. The following code only
	>	hat the following code only adds support to IE 8.		>	adds IE 8 support. This IE 8 polyfill only works in standard
				>	s mode: a doctype declaration is required.
	354	</p>
	355	<p>
	356	Also note that this IE 8 polyfill ONLY works in stan
	>	dards mode: a doctype declaration is required.
n	449	This method replaces the existing <code>click</code> event	n	448	This method replaces the existing <code>click</code> event
	>	listener(s) on the element if there are any. Other events and ass		>	listener(s) on the element if there are any. Other events and ass
	>	ociated event handlers such as <code>blur</code> (<code>onblur</c		>	ociated event handlers such as <code>blur</code> (<code>onblur</c
	>	ode>), <code>keypress</code> (<code>onkeypress</code>), and so on		>	ode>) and <code>keypress</code> (<code>onkeypress</code>) behave
	>	behave similarly.		>	similarly.
t	477	In the first case, a new (anonymous) function is created at	t	476	In the first case, a new (anonymous) function is created wi
	>	each iteration of the loop. In the second case, the same previou		>	th each iteration of the loop. In the second case, the same previ
	>	sly declared function is used as an event handler. This results i		>	ously declared function is used as an event handler. This results
	>	n smaller memory consumption. Moreover, in the first case, it is		>	in smaller memory consumption. Moreover, in the first case, it i
	>	not possible to call {{domxref("EventTarget.removeEventListener",		>	s not possible to call {{domxref("EventTarget.removeEventListener
	>	"removeEventListener()")}} because no reference to the anon		>	", "removeEventListener()")}} because no reference to the an
	>	ymous function is kept. In the second case, it's possib		>	onymous function is kept. In the second case, it's poss
	>	le to do <code>myElement.removeEventListener("click", processEven		>	ible to do <code>myElement.removeEventListener("click", processEv
	>	t, false)</code>.		>	ent, false)</code>.

Web/API/EventTarget/addEventListener (en-US)

2017-07-29T11:59:28-07:00

Edited by:

johnjago

Comment:

Perform editorial review: revise sentences for clarity and consistency, fix live demo name (forgot to add this comment to revision 1279157)

Tag changes:

	Revision 1279157			Revision 1279159
t	1	"API" "DOM" "EventTarget" "JavaScript" "Method" "Reference"	t	1	"API" "DOM" "EventTarget" "events" "JavaScript" "Method" "Referen
				>	ce"

Content changes:

Web/JavaScript/Closures (en-US)

2017-07-29T13:20:16-07:00

Edited by:

ACollectionOfAtoms

<h3>Content changes:</h3>

	Revision 1255347			Revision 1279167
t	59	Running this code has exactly the same effect as the previo	t	59	Running this code has exactly the same effect as the previo
	>	us example of the <code>init()</code> function above: this t		>	us example of the <code>init()</code> function above; what's
	>	ime, the string "Mozilla" will be displayed in a JavaScript alert		>	different — and interesting — is that the <code>displayName()</c
	>	box. What's different — and interesting — is that the <code>disp		>	ode> inner function is returned from the outer function before be
	>	layName()</code> inner function is returned from the outer functi		>	ing executed.
	>	on before being executed.

Web/API/IndexedDB_API/Basic_Concepts_Behind_IndexedDB (en-US)

2017-07-29T19:44:16-07:00

Edited by:

jarrodn

Comment:

Fixed type in "transaction" definition: "several active transaction" -> "several active transactions"

<h3>Content changes:</h3>

	Revision 1140931			Revision 1279185
t	184	A database connection can have several active transacti	t	184	A database connection can have several active transacti
	>	on associated with it at a time, so long as the writing transacti		>	ons associated with it at a time, so long as the writing transact
	>	ons do not have overlapping <a href="#scope"><em>scopes</em></a>.		>	ions do not have overlapping <a href="#scope"><em>scopes</em></a>
	>	The scope of transactions, which is defined at creation, determi		>	. The scope of transactions, which is defined at creation, determ
	>	nes which object stores the transaction can interact with and rem		>	ines which object stores the transaction can interact with and re
	>	ains constant for the lifetime of the transaction. So, for exampl		>	mains constant for the lifetime of the transaction. So, for examp
	>	e, if a database connection already has a writing transaction wit		>	le, if a database connection already has a writing transaction wi
	>	h a scope that just covers the <code>flyingMonkey</code> object s		>	th a scope that just covers the <code>flyingMonkey</code> object
	>	tore, you can start a second transaction with a scope of the <cod		>	store, you can start a second transaction with a scope of the <co
	>	e>unicornCentaur</code> and <code>unicornPegasus</code> object st		>	de>unicornCentaur</code> and <code>unicornPegasus</code> object s
	>	ores. As for reading transactions, you can have several of them —		>	tores. As for reading transactions, you can have several of them
	>	even overlapping ones.		>	— even overlapping ones.

Web/API/HTMLMediaElement/play (en-US)

2017-07-29T21:16:13-07:00

Edited by:

jarrodn

Comment:

Revert to revision of 2017-03-15 09:11:10.265019 by Sheppy: "Revisions on July 25, 2017 replaced initial paragraph with a German translation. Reverting back to restore English paragraph."

<h3>Content changes:</h3>

	Revision 1276497			Revision 1279249
t	11	Die <strong><code>HTMLMediaElement.play()</code></strong> M	t	11	The <strong><code>HTMLMediaElement.play()</code></strong> m
	>	ethode versucht die Wiedergabe der Medien zu aktivieren und der R		>	ethod attempts to begin playback of the media and returns a {{jsx
	>	ückgabewert ist {{jsxref("Promise")}} was gegeben ist wenn die Wi		>	ref("Promise")}} which is fulfilled when the playback has been su
	>	edergabe erfolgreich gestartet wurde und andernfalls abgelehnt we		>	ccessfully started, and which is rejected if playback fails to be
	>	nn die Wiedergabe nicht aus irgendeinem Grund beginnen kann (wie		>	gin for any reason (such as permission issues or other problems).
	>	Berechtigungsprobleme oder andere Probleme).

Web/API/HTMLMediaElement/srcObject (en-US)

2017-07-29T21:19:15-07:00

Edited by:

jarrodn

Comment:

Revert to revision of 2017-04-03 06:02:21.683246 by chrisdavidmills: "Revision on July 25, 2017 replaced initial paragraph with a German translation. Reverting back to restore English paragraph."

<h3>Content changes:</h3>

	Revision 1276489			Revision 1279251
t	11	Die SrcObject-Eigenschaft der {{domxref("HTMLMediaElement")	t	11	The <strong><code>srcObject</code></strong> property o
	>	}} Schnittstelle setzt oder gibt das Objekt zurück welches a		>	f the {{domxref("HTMLMediaElement")}} interface sets or returns t
	>	ls Quelle dient von den Medien im Zusammenhang mit dem {{domxref(		>	he object which serves as the source of the media associated with
	>	"HTMLMediaElement")}}. Dies ist gewöhnlich ein {{domxref("MediaSt		>	the {{domxref("HTMLMediaElement")}}. This is usually a {{domxref
	>	ream")}} aber kann entsprechend der Spezifikation auch {{domxref(		>	("MediaStream")}} but can, according to the specification, be a {
	>	"MediaSource")}} und {{domxref("Blob")}} oder {{domxref("File")}}		>	{domxref("MediaSource")}}, {{domxref("Blob")}}, or {{domxref("Fil
	>	sein.		>	e")}}.

Web/CSS/position (en-US)

2017-07-29T22:22:05-07:00

Edited by:

huusz

<h3>Content changes:</h3>

	Revision 1275267			Revision 1279259
n	11	The <strong><code>position</code></strong> <a href="/en-US/	n	11	<strong><code>position</code></strong> 속성은 도큐먼트(docume
	>	docs/CSS" title="CSS">CSS</a> property specifies how an element i		>	nt) 상에 요소를 배치하는 방법을 지정한다. {{Cssxref("top")}}, {{Cssxref("rig
	>	s positioned in a document. The {{Cssxref("top")}}, {{Cssxref("ri		>	ht")}}, {{Cssxref("bottom")}},  {{Cssxref("left")}} 속성들은 요소가
	>	ght")}}, {{Cssxref("bottom")}}, and {{Cssxref("left")}} propertie		>	최종적으로 배치될 위치를 지정한다.
	>	s determine the final location of positioned elements.
n	102	Types of positioning	n	102	위치 지정(positioning)의 유형
t	105	<li>A <strong>positioned element</strong> is an element who	t	105	<li>
	>	se <a href="/en-US/docs/CSS/computed_value" title="CSS/computed_v
	>	alue">computed</a> <code>position</code> value is either <co
	>	de>relative</code>, <code>absolute</code>, <code>fixed<
	>	/code>, or <code>sticky</code>. (In other words, it's anything ex
	>	cept <code>static</code>.)
				106	<strong>배치된</strong><strong>(positioned)</strong> <strong
				>	>요소는</strong> 상대위치, 절대위치, 고정위치(fixed와 sticky)로 <a href="http
				>	s://developer.mozilla.org/ko/docs/Web/CSS/computed_value">계산된</a>
				>	위치 값을 갖는다. (즉, static을 제외한 전부)

Mozilla/Tech/XPCOM/Guide/Building_components_in_JavaScript (en-US)

2017-07-29T23:22:10-07:00

Edited by:

hideousparadigm

Comment:

Technical review completed.

Tag changes:

	Revision 806025			Revision 1279285
t	1	"Add-ons","Extensions","JavaScript","Tutorial","XPCOM"	t	1	Add-ons, Extensions, JavaScript, Tutorial, XPCOM

Review changes:

Content changes:

	Revision 1278847			Revision 1279037
n			n	69	grid-column: 1;
t	70	grid-column: 1;	t