71 KiB
7.2.2
- Fixed
canvasEl.toDataURL()
, with thecanvas
npm package installed; a recent update to thecanvas
package broke how we were passing arguments to do. - Fixed
data:
URL parsing to allow empty contents, e.g.data:text/css;base64,
. (sebmck)
7.2.1
- Fixed a regression in XML parsing of attributes with a namespace URL but no prefix (e.g.
<math xmlns="http://www.w3.org/1998/Math/MathML">
).
7.2.0
- Added support for text selection APIs on
<input>
and<textarea>
! (sjelin and yaycmyk) - Replaced our default XML parser with sax, thus fixing many (but not all) issues with XML and XHTML parsing. To get a flavor of the issues fixed, check out these now-closed bugs: #393, #651, #415, #1276.
- Fixed the
<canvas>
tag to reset its contents when its width or height changed, including the change from the default 300 × 150 canvas. (Applies only when using thecanvas
npm package.) - Fixed an issue where
HTMLCollection
s would get confused when they contained elements with numericid
s orname
s. - Fixed an issue with doctype parsing confusing the system ID and public ID.
- Made the task posted by
postMessage
use the inside-jsdom timer queue, instead of the Node.js one. This allows easier mocking. (cpojer)
7.1.1
- When
<iframe>
s have unresolvable URLs, jsdom will no longer crash, but will instead just loadabout:blank
into them. (This is the spec behavior.) - Fixed
document.writeln
to correctly handle multiple arguments; previously it ignored all after the first. - Fixed
FileList
objects to no longer have a property named"undefined"
. (jfremy)
7.1.0
This is a rather large release bringing with it several important re-implementations of DOM and HTML APIs.
- Our
EventTarget
implementation has been rewritten from scratch to follow the spec exactly. This should improve any edge case misbehaviors. - Our
Event
class hierarchy has been rewritten and fleshed out, fixing many gaps in functionality.- Previously missing classes
KeyboardEvent
andTouchEvent
are now implemented. - Almost all supported
Event
subclasses now have constructors. (TouchEvent
does not yet, andMutationEvent
is specified to not have one.) - All classes now have correct public APIs, e.g. getters instead of data properties, missing properties added, and constructors that correctly allow setting all the supported properties.
document.createEvent("customevent", ...)
now correctly creates aCustomEvent
instead of anEvent
, andCustomEvent.prototype.initProgressEvent
has been replaced withCustomEvent.prototype.initCustomEvent
.
- Previously missing classes
- The
Attr
class and related attribute-manipulating methods has been rewritten to follow the latest specification. In particular,Attr
is no longer a subclass ofNode
, and no longer has child text nodes. - The
<template>
element implementation has been greatly improved, now passing most web platform tests. Its.content
property no longer has an extra intermediate document fragment; it no longer has child nodes; and related parts of the parser and serializer have been fixed, includinginnerHTML
andouterHTML
, to now work as specified. querySelector
,querySelectorAll
, andmatches
now correctly throw"SyntaxError"
DOMException
s for invalid selectors, instead of justError
instances.Node.prototype
'sinsertBefore
,replaceChild
, andappendChild
methods now check their arguments more correctly.- The browser builds now have regained the ability to fetch URLs for content and the like; this had been broken due to an issue with the browser-request package, which is no longer necessary anyway.
7.0.2
- Fixed an issue where inside jsdom
<script>
code,/regexpliteral/ instanceof RegExp
would befalse
.
7.0.1
- Fixed two bugs with
Node.prototype.isEqualNode
:- It would previously always return
true
for comparing any two doctypes. - It would throw an error when trying to compare two elements that had attributes.
- It would previously always return
- Enforced that
document.implementation.createDocumentType
requires all three of its arguments.
7.0.0
This major release has as its headlining feature a completely re-written XMLHttpRequest
implementation, in a heroic effort by @nicolashenry. It includes a number of other smaller improvements and fixes. The breaking changes are highlighted in bold below.
- Node.js 4.0 onward is now required, as we have begun using ES2015 features only present there.
- Completely re-implemented
XMLHttpRequest
and related classes (nicolashenry):- Includes support for
Blob
,File
,FileList
,FileReader
,FormData
,ProgressEvent
, and the supportingXMLHttpRequestUpload
, andXMLHttpRequestEventTarget
interfaces. - Includes support for synchronous XHRs.
- Adds some new request-management abilities, documented in the readme. In short, the
pool
,agentOptions
, anduserAgent
options are new, and resource loads can now be aborted. - These implementations are extremely complete and standards-compliant, passing 136 newly-introduced web platform tests.
- Includes support for
- Added
document.charset
, an alias fordocument.characterSet
. - Added
HTMLTemplateElement.prototype.content
, for getting the contents of a<template>
element as a document fragment. (rickychien) - Implemented "loose" cookie parsing, giving correct execution of code like
document.cookie = "foo"
. - Several fixes related to event dispatching and creation, including the addition of
Event.prototype.stopImmediatePropagation
and the constantsNONE
,CAPTURING_PHASE
,AT_TARGET
, andBUBBLING_PHASE
. This accounted for another 15 newly-passing web platform tests. (nicolashenry) - Fixed
document.styleSheets
to correctly track the removal of stylesheets from the document. (AVGP) - Fixed the
created
jsdom lifecycle callback receiving a differentwindow
object than theloaded
ordone
callbacks when scripting was enabled. - Invalid URLs are no longer allowed when creating a jsdom document; the URL must be parseable, or an error will be thrown.
- The
{ omitJsdomErrors }
option of the virtual console has moved; it is no longer provided when creating the virtual console, but instead when callingsendTo
.
6.5.1
- Fixed an issue where with
jsdom.jsdom
, you had to passreferrer
andcookie
options as top-level, whereas withjsdom.env
, you had to nest them under adocument
option. This was unnecessarily confusing. Now both possibilities are allowed for both functions. (The readme only documents the top-level version, though.)
6.5.0
- Added
NodeList.prototype[Symbol.iterator]
, so you can now usefor
-of
loops withNodeList
s.
6.4.0
- Added
jsdom.nodeLocation(node)
to get the location within the source text of a given node. - Added
jsdom.reconfigureWindow(window, { top })
to allow changing the value of a window'stop
property. - Added the
element
argument to the custom resource loader, so you can customize resource loads depending on which element loaded them. - Updated
getElementsByClassName
to match the spec. It now correctly splits on whitespace to try to find elements with all the given classes; it returns aHTMLCollection
instead of aNodeList
; and it memoizes the result. - Updated
NodeList
andHTMLCollection
to match the spec. The most noticable change is thatHTMLCollection
no longer inherits fromNodeList
.
6.3.0
- Added a fully spec-compliant implementation of
window.atob
andwindow.btoa
. (jeffcarp) - Fixed many issues with our
<canvas>
implementation:- With the
canvas
npm package installed,<canvas>
elements are now properlyinstanceof HTMLCanvasElement
andinstanceof HTMLElement
. <canvas>
elements now present the same uniform spec-compliant API both with and without thecanvas
npm package installed. If the package is not installed, some of the methods will cause not-implemented"jsdomError"
events to be emitted on the virtual console.- The
width
andheight
properties now correctly reflect thewidth
andheight
attributes, and have the appropriate default values of300
and150
. - With the
canvas
npm package installed,<canvas>
elements now generally play better with other parts of jsdom, e.g.,document.getElementById
actually works with them.
- With the
- Introduced and upated many of our element classes, so that at least every tag name/element class pair is now correct, even if some of the classes are stubs. In particular:
- Complete implementations were added for
HTMLDataElement
,HTMLSpanElement
, andHTMLTimeElement
. - Stubs were added for
HTMLDataListElement
,HTMLDialogElement
,HTMLEmbedElement
,HTMLMeterElement
,HTMLOutputElement
,HTMLProgressElement
,HTMLSourceElement
,HTMLTemplateElement
, andHTMLTrackElement
. HTMLAudioElement
was implemented in full, although itsHTMLMediaElement
base, where most of its functionality is, is still largely a stub.HTMLTableSectionElement
,HTMLTableRowElement
,HTMLTableCellElement
,HTMLTableDataCellElement
, andHTMLTableHeaderCellElement
were updated to the latest spec.HTMLIsIndexElement
was removed; it has never been produced by the parser since 1.0.0-pre.1, and so it has been just a vestigial global property.- Appropriate constants were added to
HTMLMediaElement
.
- Complete implementations were added for
- Updated everything having to do with base URLs to be per-spec:
- Added
Node.prototype.baseURI
property to get the node's owner document's base URL. HTMLBaseElement
'shref
getter now contains appropriate fallbacks and always returns an absolute URL, per spec.- If there are no
base
elements in an"about:blank"
iframe document, the base URL correctly falls back to the parent window's base URL.
- Added
- When you provide a
url: ...
option tojsdom.jsom()
orjsdom.env()
, the given string is now attempted to be resolved as a URL before it is installed asdocument.URL
.- So for example, providing
url: "http://example.com"
will meandocument.URL
returns"http://example.com/"
, with a trailing slash. - In a future major release, we will start throwing if strings that cannot be parsed as valid absolute URL are provided for this option.
- So for example, providing
6.2.0
- Added a full-featured, spec-compliant
Element.prototype.classList
, closing out a three-year old issue! (wacii) - Made
virtualConsole.sendTo(console)
forward"jsdomError"
s toconsole
by callingconsole.error
. This can be turned off by doingvirtualConsole.sendTo(console, { omitJsdomErrors: true })
. - Fixed errors when trying to parse invalid doctype declarations, like
<!DOCTYPE>
. - Fixed spurious
"jsdomError"
s that were emitted after callingwindow.close()
. - Fixed the
"DOMSubtreeModified"
event to fire in more cases. Note that our mutation events implementation remains incomplete, and will eventually be removed (in a major release) once we implement mutation observers. (selam)
6.1.0
- Added basic implementations of
HTMLMediaElement
andHTMLVideoElement
, back-ported from Facebook's Jest project. (cpojer)
6.0.1
- Fixed
XMLHttpRequest.prototype.getAllResponseHeaders
to not crash when used withfile:
URLs. (justinmchase) - Fixed
XMLHttpRequest.prototype.response
to correctly return the response text even whenresponseType
was unset. (justinmchase)
6.0.0
This major release is focused on massive improvements in speed, URL parsing, and error handling. The potential breaking changes are highlighted in bold below; the largest ones are around the jsdom.env
error-handling paradigm.
This release also welcomes long-time contributer @Joris-van-der-Wel to the core team. You may recognize him from earlier changelogs. We're very happy to have his help in making jsdom awesome!
- io.js 2.0 onward is now required, as we have begun using ES2015 features only present there.
- Improved performance dramatically, by ~10000x in some cases, due to the following changes:
- Overhauled the named properties tracker to not walk the entire tree, thus greatly speeding up the setting of
id
andname
attributes (including during parsing). - Overhauled everything dealing with tree traversal to use a new library, symbol-tree, to turn many operations that were previously O(n^2) or O(n) into O(n) or O(1).
- Sped up
node.compareDocumentPosition
and anything that used it (likenode.contains
) by doing more intelligent tree traversal instead of directly implementing the specced algorithm.
- Overhauled the named properties tracker to not walk the entire tree, thus greatly speeding up the setting of
- Overhauled how error handling works in jsdom:
window.onerror
(orwindow.addEventListener("error", ...)
) now work, and will catch all script errors, similar to in browsers. This also introduces theErrorEvent
class, incidentally.- The virtual console is now the destination for several types of errors from jsdom, using the new event
"jsdomError"
. This includes: errors loading external resources; script execution errors unhandled bywindow.onerror
; and not-implemented warnings resulting from calling methods likewindow.alert
which jsdom explicitly does not support. - Since script errors are now handled by
window.onerror
and the virtual console, they are no longer included in the initialization process. This results in two changes tojsdom.env
and the initialization lifecycle:- The
load(errors, window)
callback was changed toonload(window)
, to reflect that it is now just sugar for setting awindow.onload
handler. - The
done(errors, window)
callback (i.e., the default callback forjsdom.env
) has becomedone(error, window)
, and like every other io.js callback now simply gives you a single error object, instead of an array of them.
- The
- Nodes no longer have a nonstandard
errors
array, or araise
method used to put things in that array.
- URL parsing and resolution was entirely overhauled to follow the URL standard!
- This fixes several long-standing bugs and hacks in the jsdom URL parser, which already had a mess of gross patches on top of the built-in io.js parser to be more web-compatible.
- The new
URL
class has been added towindow
- The interfaces for
HTMLAnchorElement.prototype
anddocument.location
(as well asURL
, of course) are now uniformized to follow theURLUtils
API (minussearchParams
for now). - As part of this change, you may need to start passing in
file:
URLs tojsdom.env
where previously you were able to get away with passing in filenames.
- Added the
XMLHttpRequest.prototype.response
getter. - Fixed
StyleSheetList.prototype.item
to actually work. (chad3814) - Fixed the browser
vm
shim to properly add the built-in global properties (Object
,Array
, etc.) to the sandbox. If you were running jsdom inside a web worker and most of your scripts were broken, this should fix that. - Fixed the
"hashchange"
event to correctly fireHashChangeEvent
instances, with correct propertiesnewURL
andoldURL
(instead of the incorrectnewUrl
andoldUrl
used previously). - Removed usage of the setimmediate library, as it required
eval
and thus did not work in CSP scenarios.
Finally, if you're a loyal jsdom fan whose made it this far into the changelog, I'd urge you to come join us in #1139, where we are brainstorming a modernized jsdom API that could get rid of many of the warts in the current one.
5.6.1
- Fixed an accidentally-created global
attribute
variable if you ever calledcreateAttributeNS
. - Dependency upgrades fixed a couple of bugs, although you would have gotten these anyway with a clean jsdom 5.6.0 install:
- Parsing of CSS properties that use
url("quoted string")
now works correctly, as of cssstyle 0.2.29. - Selectors for the empty string, like
div[title=""]
, now work correctly, as of nwmatcher 1.3.6.
- Parsing of CSS properties that use
5.6.0
virtualConsole.sendTo
now returnsthis
, allowing for a nice shorthand. (jeffcarp)
5.5.0
- Added
postMessage
support, for communicating between parent windows, iframes, and combinations thereof. It's missing a few semantics, especially around origins, as well as MessageEvent source. Objects are not yet structured cloned, but instead passed by reference. But it's working, and awesome! (jeffcarp) - Rewrote cloning code (underlying
cloneNode
andimportNode
), fixing a number of issues:- Elements with weird tag names, of the type that only the parser can normally create, can now be cloned (#1142)
- Doctypes can now be cloned, per the latest spec.
- Attrs cannot be cloned, per the latest spec (although they still have a
cloneNode
method for now due to legacy). - Document clones now correctly copy over the URL and content-type.
- Fixed any virtual console output from iframes to be proxied to the parent window's virtual console. (jeffcarp)
- Fixed the
type
property of<button>
elements to correctly default tosubmit
, and to stay within the allowed range. - Fixed clicking on submit
<button>
s to submit their containing form; previously only<input type="submit">
worked. (rxgx) - Fixed
document.open()
to returnthis
, per spec. (ryanseddon)
Additionally, Joris-van-der-Wel added a benchmarking framework, and a number of benchmarks, which should help us avoid performance regressions going forward, and also make targeted performance fixes. We're already investigating some real-world issues using this framework. Very exciting!
5.4.3
- Incorporated upstream fix for setting
el.style.cssText
to an invalid value, which should be ignored instead of causing an error to be thrown. This same bug has also caused an error while setting the style attribute to an invalid value, ever since 5.4.0. (Joris-van-der-Wel; chad3814 upstream)
5.4.2
- Fixed license metadata to conform to latest npm standards.
5.4.1
- Fixed to work with browserify again (regression introduced in 5.4.0).
5.4.0
This is a pretty exciting release! It includes a couple features I never really anticipated jsdom being awesome enough to have, but our wonderful contributors powered through and made them happen anyway:
- Added support for the default HTML stylesheet when using
window.getComputedStyle
! (akhaku)- Notably, this makes jQuery's
show()
andhide()
methods now work correctly; see #994.
- Notably, this makes jQuery's
- Added support for named properties on
window
: any elements with anid
attribute, or certain elements with aname
attribute, will cause properties to show up on thewindow
, and thus as global variables within the jsdom. (Joris-van-der-Wel)- Although this is fairly unfortunate browser behavior, it's standardized and supported everywhere, so the fact that jsdom now supports this too means we can run a lot of scripts that would previously fail.
- Previously, we only supported this for
<iframe>
s, and our implementation was quite buggy: e.g.,<iframe name="addEventListener">
would overridewindow.addEventListener
. - Now that we have the infrastructure in place, we anticipate expanding our support so that this works on e.g.
HTMLFormElement
s as well in the future.
We also have a bunch more fixes and additions:
- Implemented the
NonDocumentTypeChildNode
mixin. Practically, this means addingnextElementSibling
andpreviousElementSibling
toElement
and the various types ofCharacterData
. (brandon-bethke-neudesic) - Updated
StyleSheetList
to inherit fromArray
, as per the latest CSSOM spec. - Overhauled the handling of attributes throughout the DOM, to follow the spec more exactly.
- Our
NamedNodeMap
implementation is up to date, as are the variousElement
methods; other places in the code that deal with attributes now all go through a spec-compliant set of helpers. - Some weirdnesses around the
style
attribute were fixed along the way; see e.g. #1109. - However,
Attr
objects themselves are not yet spec-compliant (e.g., they still inherit fromNode
). That's coming soon.
- Our
- Fixed an unfortunate bug where
getElementById
would fail to work correctly on<img>
elements whoseid
attributes were modified. (Joris-van-der-Wel) - Fixed the
virtualConsole
option to work withjsdom.env
, not justjsdom.jsdom
. (jeffcarp) - Removed a few functions that were erroneously added to
window
:mapper
,mapDOMNodes
, andvisitTree
. (Joris-van-der-Wel)
5.3.0
- Added a
virtualConsole
option to the document creation methods, along with thejsdom.createVirtualConsole
factory. (See examples in the readme.) With this option you can install a virtual console before the document is even created, thus allowing you to catch any virtual console events that occur during initialization. (jeffcarp)
5.2.0
- Implemented much of the
ParentNode
mixin (Joris-van-der-Wel):- Moved
children
fromNode
toParentNode
, i.e., made it available onDocument
,DocumentFragment
, andElement
, but not other types of nodes. - Made
children
aHTMLCollection
instead of aNodeList
. - Implemented
firstElementChild
,lastElementChild
, andchildElementCount
.
- Moved
- Implemented the
outerHTML
setter. (Joris-van-der-Wel) - Fixed the
outerHTML
getter for<select>
and<form>
. (Joris-van-der-Wel) - Fixed various issues with window-less documents, so that they no longer give incorrect results or blow up in strange ways. You can create such documents with e.g.
document.implementation.createHTMLDocument()
. (Joris-van-der-Wel) - Fixed relative stylesheet resolution when using
@import
. (dbo)
5.1.0
- Added support for the
NodeIterator
class from the DOM Standard. (Joris-van-der-Wel) - Fixed an issue with the initial request where it was not sharing its cookie jar with the subsequent requests, sometimes leading to a "possible EventEmitter memory leak detected" warning. (inikulin)
- Updated tough-cookie to 0.13.0, bringing along many spec compliance fixes. (inikulin)
- Added a fast failure in Node.js™ with a clear error message, so that people don't get confused by syntax errors.
5.0.1
- Fixed
document.cookie
setter to no longer ignorenull
; instead it correctly sets a cookie of"null"
. (Chrome is not compliant to the spec in this regard.) - Fixed documents created with
parsingMode: "xml"
to no longer get"<html><head></head><body></body></html>"
automatically inserted when callingjsdom.jsdom()
with no arguments. - Fixed the
innerHTML
setter to no longer ignoreundefined
; instead it correctly sets the innerHTML to"undefined"
. - Fixed
document.write
to throw for XML documents as per the spec. - Fixed
document.write
to accept more than one argument (they get concatenated). - Fixed
document.write("")
to no longer try to write"<html><head></head><body></body></html>"
.
5.0.0
This release overhauls how cookies are handled in jsdom to be less fiddly and more like-a-browser. The work for this was done by @inikulin, who is also our beloved parse5 maintainer.
You should only need to worry about upgrading to this release if you use jsdom's cookie handling capabilities beyond the basics of reading and writing to document.cookie
. If that describes you, here's what changed:
- Removed
options.jar
andoptions.document.cookieDomain
from the configuration for creating jsdom documents. - Instead, there is now a new option,
options.cookieJar
, which accepts cookie jars created by the newjsdom.createCookieJar()
API. You should use this if you intend to share cookie jars among multiple jsdom documents. - Within a given cookie jar, cookie access is now automatically handled on a domain basis, as the browser does, with the domain calculated from the document's URL (supplied as
options.url
when creating a document). This supplants the formeroptions.document.cookieDomain
.
In addition to these changes to the public API, the following new cookie-related features came along for the ride:
- Implemented automatic cookie-jar sharing with descendant
<iframe>
s. (So, if the iframe is same-domain, it can automatically access the appropriate cookies.) - Let
options.document.cookie
accept arrays, instead of just strings, for if you want to set multiple cookies at once.
Finally, it's worth noting that we now delegate our cookie handling in general to the tough-cookie package, which should hopefully mean that it now captures many of the behaviors that were previously missing (for example #1027). @inikulin is working on a large pull request to fix tough-cookie to be more spec compliant, which should automatically be picked up by jsdom installs once it is merged.
4.5.1
- Removed unnecessary browserify dependency that was erroneously included in 4.5.0.
4.5.0
- Added
document.currentScript
. (jeffcarp)
4.4.0
- All resources are now loaded with the request package, which means that e.g. GZIPped resources will be properly uncompressed, redirects will be followed, and more. This was previously the case only for URLs passed directly to
jsdom.env
, and not for sub-resources inside the resulting page. (ssesha)
4.3.0
- Made the click behavior for radio buttons and checkboxes work when doing
el.dispatchEvent(clickEvent)
, not just when doingel.click()
. (brandon-bethke-neudesic) - Added
defaultPrevented
property toEvent
instances, reflecting whetherev.preventDefault()
has been called. (brandon-bethke-neudesic) - Moved the
click()
method fromHTMLInputElement.prototype
toHTMLElement.prototype
, per the latest spec. - Made the
click()
method trigger aMouseEvent
instead of just anEvent
.
4.2.0
- Added a second parameter to
UIEvent
,MouseEvent
, andMutationEvent
, which for now just behaves the same as that forEvent
. (Rich-Harris)
4.1.0
- Added a second parameter to the
Event
constructor, which allows you to set thebubbles
andcancelable
properties. (brandon-bethke-neudesic)
4.0.5
- Added
HTMLUnknownElement
and fix the parser/document.createElement
to create those instead ofHTMLElement
for unknown elements. - Fixed issues with named and indexed properties on
window
, as well aswindow.length
, with regard to<frame>
s/<iframe>
s being added and removed from the document.
Note: this probably should have been a minor version number increment (i.e. 4.1.0 instead of 4.0.5), since it added HTMLUnknownElement
. We apologize for the deviation from semver.
4.0.4
- Fixed parsing of doctypes by relying on the information provided by the html parser if possible.
4.0.3
- Fixed events fired from
EventTarget
s to execute their handlers in FIFO order, as per the spec. - Fixed a case where
childNodes
would not be correctly up to date in some cases. (medikoo) - Sped up window creation with
jsdom.env
by ~600%, for the special case when no scripts are to be executed.
4.0.2
EventTarget
is now correctly in the prototype chain ofWindow
.EventTarget
argument validation is now correct according to the DOM Standard.DOMException
now behaves more like it should per Web IDL. In particular it has a more comprehensive set of constants, and instances now havename
properties.new Event("click")
can now be dispatched. (lovebear)document.createEvent
now behaves more like it should according to the DOM Standard: it accepts a wider range of arguments, but will throw if an invalid one is given. (lovebear)- Fixed a regression in our browser support that required Chrome 41 as of 4.0.1; now Chrome 40 will work, as well as (in theory, although less well-tested) the latest stable versions of Firefox and IE.
4.0.1
- Fixed:
Node.prototype.contains
to always return a boolean. This was a regression in 3.1.1. (Joris-van-der-Wel) - Fixed:
Document.prototype
no longer contains its ownownerDocument
getter, instead correctly delegating toNode.prototype
. - Fixed: some edge cases regarding running
<script>
s in browserified jsdom. - A couple fixes from updated dependencies (although you would have gotten these anyway with a fresh install, due to floating version specifiers):
- csstyle minimum version bumped from 0.2.21 to 0.2.23, fixing handling of
0
when setting numeric CSS properties and parsing of shorthandfont
declarations. - parse5 minimum version bumped from 1.3.1 to 1.3.2 to, fixing the parsing of
<form>
elements inside<template>
elements.
- csstyle minimum version bumped from 0.2.21 to 0.2.23, fixing handling of
4.0.0
This release relies on the newly-overhauled vm
module of io.js to eliminate the Contextify native module dependency. jsdom should now be much easier to use and install, without requiring a C++ compiler toolchain!
Note that as of this release, jsdom no longer works with Node.js™, and instead requires io.js. You are still welcome to install a release in the 3.x series if you are stuck on legacy technology like Node.js™.
In the process of rewriting parts of jsdom to use vm
, a number of related fixes were made regarding the Window
object:
- In some cases, state was implicitly shared between
Window
instances—especially parser- and serializer-related state. This is no longer the case, thankfully. - A number of properties of
Window
were updated for spec compliance: some data properties became accessors, and all methods moved from the prototype to the instance. - The non-standard
document.parentWindow
was removed, in favor of the standarddocument.defaultView
. Our apologies for encouraging use ofparentWindow
in our README, tests, and examples.
3.1.2
- Some fixes to the
NOT_IMPLEMENTED
internal helper, which should eliminate the cases where calling e.g.window.alert
crashes your application. - Fixed a global variable leak when triggering
NOT_IMPLEMENTED
methods, likewindow.location.reload
. - Fixed the URL resolution algorithm to handle
about:blank
properly on all systems (previously it only worked on Windows). This is especially important since as of 3.0.0 the default URL isabout:blank
. - Fixed, at least partially, the ability to run
<script>
s inside a browserified jsdom instance. This is done by dynamically rewriting the source code so that global variable references become explicit references towindow.variableName
, so it is not foolproof.
3.1.1
- Updated
Node.prototype.isEqualNode
to the algorithm of the DOM Standard, fixing a bug where it would throw an error along the way. - Removed
Node.prototype.isSameNode
, which is not present in the DOM Standard (and was just a verbose===
check anyway). - Fixed a couple small issues while browserifying, mainly around
jsdom.env
. However, while doing so discovered that<script>
s in general don't work too well in a browserified jsdom; see #1023.
3.1.0
- Added support for custom external resource loading. (tobie)
3.0.3
- Fixed some stray byte-order marks in a couple files, which incidentally break Browserify. (sterpe)
3.0.2
- Fixed another edge case where unchecking a radio button would incorrectly uncheck radio buttons outside the containing form. (zpao)
3.0.1
- Fixed errors when serializing text nodes (possibly only occurred when inside
<template>
). - Handle null bytes being passed to
jsdom.env
's autodetecting capabilities. (fluffybunnies) - Handle empty HTML strings being passed to
jsdom.env
'shtml
option. (fluffybunnies)
3.0.0
This release updates large swathes of the DOM APIs to conform to the standard, mostly by removing old stuff. It also fixes a few bugs, introduces a couple new features, and changes some defaults.
3.0.x will be the last release of jsdom to support Node.js. All future releases (starting with 4.0.0) will require io.js, whose new vm
module will allow us to remove our contextify native-module dependency. (Given that I submitted the relevant patch to joyent/node 1.5 years ago, I'm very excited that we can finally use it!)
- By default documents now use
about:blank
as their URL, instead of trying to infer some type of file URL from the call site (in Node.js) or usinglocation.href
(in browsers). - Introduced a new "virtual console" abstraction for capturing console output from inside the page. See the readme for more information. Note that
console.error
will no longer contribute to the (non-standard, and likely dying in the future)window.errors
array. (jeffcarp) - Added the named
new Image(width, height)
constructor. (vinothkr) - Fixed an exception when using
querySelector
with selectors likediv:last-child > span[title]
. - Removed all traces of entities, entity types, notations, default attributes, and CDATA sections.
- Differentiated between XML and HTML documents better, for example in how they handle the casing of tag names and attributes.
- Updated
DOMImplementation
to mostly work per-spec, including removingaddFeature
andremoveFeature
methods, theownerDocument
property, and makinghasFeature
always returntrue
. - Re-did the
CharacterData
implementation to follow the algorithms in the DOM Standard; this notably removes a few exceptions that were previously thrown. - Re-did
Comment
,Text
, andProcessingInstruction
to follow the DOM Standard and derive fromCharacterData
. - Re-did
DocumentType
to follow the DOM Standard and be much simpler, notably removing notations, entities, and default attributes. - Fixed a variety of accessors on
Node
,Element
,Attr
, andDocument
; some were removed that were nonstandard (especially setters); others were updated to reflect the spec; etc. - Re-did name/qname validation, which is done by various APIs, to work with the xml-name-validator package and some centralized algorithms.
- Made the XML parser at least somewhat aware of processing instructions.
- Cleaned up doctype parsing and association between doctypes and documents. More exotic doctypes should parse better now.
document.contentType
now is generally inferred from the parsing mode of the document.- Moved some properties to
Document.prototype
andWindow.prototype
instead of setting them as own properties during the document/window creation. This should improve memory usage (as well as spec compliance).
2.0.0
This release is largely a refactoring release to remove the defunct concept of "levels" from jsdom, in favor of the living standard model that browsers follow. Although the code is still organized that way, that's now noted as a historical artifact. The public API changes while doing so were fairly minimal, but this sets the stage for a cleaner jsdom code structure going forward.
- Removed:
jsdom.level
, and thelevel
option fromjsdom.jsdom
. - Change: the nonstandard
Element.prototype.matchesSelector
method was replaced with the standardElement.prototype.matches
. (KenPowers) - Fix:
querySelector
correctly coerces its argument to a string (1.2.2 previously fixed this forquerySelectorAll
).
1.5.0
- Add: missing
window.console
methods, viz.assert
,clear
,count
,debug
,group
,groupCollapse
,groupEnd
,table
,time
,timeEnd
, andtrace
. All exceptassert
do nothing for now, but see #979 for future plans. (jeffcarp) - Tweak: make
childNodes
, and the many places in jsdom that use it, much faster. (Joris-van-der-Wel)
1.4.1
- Tweak: faster implementation of
NodeList.prototype.length
, which should speed up common operations likeappendChild
and similar. (Joris-van-der-Wel)
1.4.0
- Fix:
HTMLInputElement.prototype.checked
anddefaultChecked
now behave per the spec. (Joris-van-der-Wel) - Fix:
HTMLOptionElement.prototype.selected
now behaves per the spec. (Joris-van-der-Wel) - Fix:
HTMLInputElement.prototype.value
now behaves per the spec. (Joris-van-der-Wel) - Fix:
HTMLTextAreaElement.prototype.value
anddefaultValue
now behave per the spec. (Joris-van-der-Wel) - Add:
HTMLTextAreaElement.prototype.defaultValue
now has a setter, andHTMLTextAreaElement.prototype.textLength
now exists. (Joris-van-der-Wel) - Fix: resetting a
<form>
now behaves per spec for all different types of form elements. (Joris-van-der-Wel) - Fix: radio buttons reset other radio buttons correctly now per the spec. (Joris-van-der-Wel)
- Fix:
document.cloneNode
now works. (AVGP) - Fix:
hasAttribute
is now case-insensitive, as it should be. (AVGP) - Fix:
div.toString()
now returns[object HTMLDivElement]
. (AVGP)
1.3.2
- Fix: check if
module.parent
exists before using it to construct a document's initial URL. Apparently some testing frameworks like Jest do not correctly emulate the module environment; this compensates. (SegFaultx64)
1.3.1
- Fix: changing attributes on
<option>
elements will now have the correct consequences. For example changing theid
attribute now interacts correctly withdocument.getElementById
. (Joris-van-der-Wel)
1.3.0
- Add: moved
focus
andblur
methods toHTMLElement.prototype
, instead of having them only be present on certain element prototypes. Our focus story is still not very spec-compliant, but this is a step in the right direction. (vincentsiao)
1.2.3
- Tweak: improve performance of
Node.prototype.insertBefore
,Node.prototype.removeChild
, and severalAttributeList
methods. (Joris-van-der-Wel)
1.2.2
- Fix:
querySelectorAll
correctly coerces its argument to a string; notably this allows you to pass arrays. (jeffcarp) - Fix: the
data
setter on text nodes correctly coerces the new value to a string. (medikoo) - Fix:
document.toString()
now returns[object HTMLDocument]
. (jeffcarp)
1.2.1
- Fix: handling of
<template>
element parsing and serialization, now that it is supported by parse5. (inikulin)
1.2.0
- Add:
NodeFilter
, in particular its constants. (fhemberger) - Fix: initial
history.length
should be1
, not0
. (rgrove) - Fix:
history.pushState
andhistory.replaceState
should not fire thepopstate
event. (rgrove)
1.1.0
- Add:
document.implementation.createHTMLDocument()
. (fhemberger) - Fix:
localName
was sometimesnull
for elements when it should not be. (fhemberger)
1.0.3
- Update: no longer requiring separate
cssstyle
andcssstyle-browserify
dependencies; nowcssstyle
can be used directly. This also un-pins thecssstyle
dependency so that future fixes arrive as they appear upstream.
1.0.2
- Fix: temporarily pin
cssstyle
dependency to at most 0.2.18 until chad3814/CSSStyleDeclaration#20 is fixed. - Fix: browserifying jsdom should work better now that the required packages are included as
dependencies
instead ofdevDependencies
. (Sebmaster) - Fix: using
jsom.env
in a browser environment now correctly defaultsoptions.url
tolocation.href
instead of trying to infer a reasonablefil://
URL using techniques that fail in the browser. (rattrayalex)
1.0.1
- Fix: the return value of
EventTarget.prototype.dispatchEvent
should betrue
when the default is not prevented; previously it was the opposite. (eventualbuddha)
1.0.0
For a consolidated list of changes from 0.11.1 to 1.0.0, see this wiki page.
- Remove: nonstandard
EventTarget.getListeners
;EventTarget.forwardIterator
;EventTarget.backwardIterator
;EventTarget.singleIterator
. - Remove: nonstandard
document.innerHTML
. (jorendorff) - Fix:
value
anddefaultValue
properties of aHTMLInputElement
are now correctly synced to thevalue=""
attribute. (Sebmaster)
1.0.0-pre.7
- Remove: support for old, untested HTML and XML parsers, namely davglass/node-htmlparser and isaacs/sax-js. In the future we plan to work toward a standardized parsing interface that other parsers can implement, instead of adding custom code to jsdom for various parsers. This interface still is being decided though, as it needs to support complex things like pausing the parse stream (for
document.write
) and parsing disconnected fragments (fordocument.innerHTML
). (Sebmaster) - Add: new
parsingMode
configuration, to allow you to manually specify XML or HTML. (Sebmaster) - Change: jsdom will no longer use the presence of
<?xml
or similar to attempt to auto-detect XHTML documents. Instead, it will by default treat them the same as browsers do, with the<?xml
declaration just being a bogus comment. If you need your document interpreted as XHTML instead of HTML, use theparsingMode
option. (Sebmaster) - Tweak: memoize various DOM-querying functions (e.g.
getElementsByTagName
,querySelector
, etc.) to improve performance. (ccarpita)
1.0.0-pre.6
- Fix: another parsing issues with void elements and
innerHTML
, this time related to disconnected nodes. This was a regression between 0.11.1 and 1.0.0-pre.1. (paton) - Fix: same-named radio inputs should not be mutually exclusive unless they are in the same form. (stof)
1.0.0-pre.5
- Fix: sometimes calling
window.close()
would cause a segfault. (paton)
1.0.0-pre.4
- Fix: attributes and elements now have their
prefix
,localName
, andnamespaceURI
properties set correctly in all cases. (Exceptingapplication/xhtml+xml
mode, which jsdom does not support yet.) (Sebmaster)
1.0.0-pre.3
- Fix: void elements no longer parsed correctly when using
innerHTML
. This was a regression between 0.11.1 and 1.0.0-pre.1. (Sebmaster)
1.0.0-pre.2
- Fix: parsing and serialization of attributes in the form
x:y
, e.g.xmlns:xlink
orxlink:href
. This was a regression between 0.11.1 and 1.0.0-pre.1. (Sebmaster)
1.0.0-pre.1
This is a prerelease of jsdom's first major version. It incorporates several great additions, as well as a general cleanup of the API surface, which make it more backward-incompatible than usual. Starting with the 1.0.0 release, we will be following semantic versioning, so that you can depend on stability within major version ranges. But we still have a few more issues before we can get there, so I don't want to do 1.0.0 quite yet.
This release owes a special thanks to @Sebmaster, for his amazing work taking on some of the hardest problems in jsdom and solving them with gusto.
Major changes
- jsdom now can be browserified into a bundle that works in web workers! This is highly experimental, but also highly exciting! (lawnsea)
- An overhaul of the initialization lifecycle, to bring more control and address common use cases. (Sebmaster)
- The excellent parse5 HTML parser is now the default parser, fixing many parsing bugs and giving us full, official-test-suite-passing HTML parsing support. This especially impacts documents that didn't include optional tags like
<html>
,<head>
, or<body>
in their source. We also use parse5 for serialization, fixing many bugs there. (Sebmaster) - As part of the new parser story, we are not supporting XML for now. It might work if you switch to a different parser (e.g. htmlparser2), but in the end, HTML and XML are very different, and we are not attempting to be an XML DOM. That said, we eventually want to support XML to the same extent browsers do (i.e., support XHTML and SVG, with an appropriate MIME type switch); this is being planned in #820.
Removed jsdom APIs
jsdom.createWindow
: usedocument.parentWindow
after creating a documentjsdom.html
: usejsdom.jsdom
jsdom.version
: userequire("jsdom/package.json").version
jsdom.level
: levels are deprecated and will probably be removed in 2.0.0jsdom.dom
jsdom.browserAugmentation
jsdom.windowAugmentation
Changed jsdom APIs
jsdom.jsdom
no longer takes a level as its second argument.jsdom.jQueryify
now requires a jQuery URL, since always picking the latest was a bad idea.
Removed non-standard DOM APIs
document.createWindow
: usedocument.parentWindow
document.innerHTML
anddocument.outerHTML
: use the newjsdom.serializeDocument
to include the DOCTYPE, or usedocument.documentElement.outerHTML
to omit it.
Other fixes
- Allow empty strings to be passed to
jsdom.env
. (michaelmior) - Fix for a memory leak in
EventTarget.prototype.dispatchEvent
. (Joris-van-der-Wel) - Make event listeners in the capture phase also fire on the event target. (Joris-van-der-Wel)
- Correctly reset
eventPhase
andcurrentTarget
on events, before and after a dispatch. (Joris-van-der-Wel) - Fix
document.cookie = null
to not throw, but instead just do nothing. (kapouer)
0.11.1
- Add:
Node.prototype.parentElement
. (lukasbuenger) - Fix: attributes that are reflected as properties should be
''
when not present, instead ofnull
. (Note thatgetAttribute
still returnsnull
for them). (thejameskyle) - Fix:
textContent
now works for nodes that do not have children, like text nodes for example. (hayes) - Fix:
jsdom.jQueryify
was using the wrong URL for jQuery by default. (lukasbuenger)
0.11.0
- Add: new default level,
living
, reflecting our focus on the DOM Living Standard and the HTML Living Standard, which are what browsers actually implement. This should open the door for more features of the modern DOM and HTML specs to be implemented in jsdom. (robotlovesyou) - Add:
Node.prototype.contains
now implemented. (robotlovesyou) - Add:
navigator.cookieEnabled
now implemented; it always returnstrue
. (Sebmaster) - Change: DOCTYPEs no longer have their
name
property uppercased during parsing, and appear in the output ofdocument.innerHTML
. - Fix:
Node.prototype.compareDocumentPosition
implemented correctly; various document position constants added to theNode
constructor. (robotlovesyou) - Fix:
DocumentType.prototype.parentNode
now returns the document node, notnull
. (robotlovesyou) - Fix: various
navigator
properties are now getters, not data properties. (Sebmaster) - Fix: a bug involving invalid script paths and
jsdom.jQueryify
. (Sebmaster)
0.10.6
- Add: remaining URL properties to
window.location
andHTMLAnchorElement
. - Fix: the presence of
String.prototype.normalize
, which is available by default in Node 0.11.13 onwards, caused reflected attributes to break. (brock8503) - Fix: iframes now correctly load
about:blank
when thesrc
attribute is empty or missing. (mcmathja) - Fix: documents containing only whitespace now correctly generate wrapper documents, just like blank documents do. (nikolas)
- Tweak: lazy-load the request module, to improve overall jsdom loading time. (tantaman)
0.10.5
- Fix: the list of void elements has been updated to match the latest HTML spec.
- Fix: when serializing void elements, don't include a
/
: i.e. the result is now<br>
instead of<br />
.
0.10.4
- Fix: another case was found where jQuery 1.11's
show()
method would cause errors. - Add:
querySelector
andquerySelectorAll
methods toDocumentFragment
s. (Joris-van-der-Wel)
0.10.3
- Fix: various defaults on
HTMLAnchorElement
andwindow.location
should not benull
; they should usually be the empty string.
0.10.2
- Fix: Using jQuery 1.11's
show()
method would cause an error to be thrown. - Fix:
window.location
properties were not updating correctly after usingpushState
orreplaceState
. (toomanydaves)
0.10.1
- Fix:
window.location.port
should default to""
, notnull
. (bpeacock)
0.10.0
- Add: a more complete
document.cookie
implementation, that supports multiple cookies. Note that options likepath
,max-age
, etc. are still ignored. (dai-shi)
0.9.0
- Add: implement attribute ordering semantics from WHATWG DOM spec, and in general overhaul attribute storage implementation to be much more awesome and accurate. (lddubeau)
- Add:
port
andprotocol
toHTMLAnchorElement
. (sporchia) - Fix: make
HTMLInputElement
not have atype
attribute by default. It still has a default value for thetype
property, viz."text"
. (aredridel) - Fix: treat empty namespace URI as meaning "no namespace" with the
getAttributeNS
,hasAttributeNS
, andsetAttributeNS
functions. (lddubeau) - Fix: reference typed arrays in a way that doesn't immediately break on Node 0.6. Node 0.6 isn't supported in general, though. (kangax)
0.8.11
- Add: store and use cookies between requests; customizable cookie jars also possible. (stockholmux)
- Fix: attributes named the same as prototype properties of
NamedNodeMap
no longer break jsdom. (papandreou) - Fix:
removeAttributeNS
should not throw on missing attributes. (lddubeau) - Change: remove
__proto__
,__defineGetter__
, and__defineSetter__
usage, as part of a project to make jsdom work better across multiple environments. (lawnsea)
0.8.10
- Add:
hash
property toHTMLAnchorElement
. (fr0z3nk0)
0.8.9
- Upgrade:
cssom
to 0.3.0, adding support for@-moz-document
and fixing a few other issues. - Upgrade:
cssstyle
to 0.2.6, adding support for many shorthand properties and better unit handling.
0.8.8
- Fix: avoid repeated
NodeList.prototype.length
calculation, for a speed improvement. (peller)
0.8.7
- Add:
host
property toHTMLAnchorElement
. (sporchia)
0.8.6
- Fix: stop accidentally modifying
Error.prototype
. (mitar) - Add: a dummy
getBoundingClientRect
method, that returns0
for all properties of the rectangle, is now implemented. (F1LT3R)
0.8.5
- Add:
href
property onCSSStyleSheet
instances for external CSS files. (FrozenCow)
0.8.4
- Add: typed array constructors on the
window
. (nlacasse) - Fix:
querySelector
andquerySelectorAll
should be on the prototypes ofElement
andDocument
, not own-properties. (mbostock)
0.8.3
- Fix: when auto-detecting whether the first parameter to
jsdom.env
is a HTML string or a filename, deal with long strings correctly instead of erroring. (baryshev)
0.8.2
- Add: basic
window.history
support, includingback
,forward
,go
,pushState
, andreplaceState
. (ralphholzmann) - Add: if an
<?xml?>
declaration starts the document, will try to parse as XML, e.g. not lowercasing the tags. (robdodson) - Fix: tag names passed to
createElement
are coerced to strings before evaluating.
0.8.1 (hotfix)
- Fix: a casing issue that prevented jsdom from loading on Unix and Solaris systems. (dai-shi)
- Fix:
window.location.replace
was broken. (dai-shi) - Fix: update minimum htmlparser2 version, to ensure you get the latest parsing-related bugfixes.
0.8.0
- Add: working
XMLHttpRequest
support, including cookie passing! (dai-shi) - Add: there is now a
window.navigator.noUI
property that evaluates to true, if you want to specifically distinguish jsdom in your tests.
0.7.0
- Change: the logic when passing
jsdom.env
a string is more accurate, and you can be explicit by using thehtml
,url
, orfile
properties. This is a breaking change in the behavior ofhtml
, which used to do the same auto-detection logic as the string-only version. - Fix: errors raised in scripts are now passed to
jsdom.env
's callback. (airportyh) - Fix: set
window.location.href
correctly when usingjsdom.env
to construct a window from a URL, when that URL causes a redirect. (fegs) - Add: a more complete and accurate
window.location
object, which includes firinghashchange
events when the hash is changed. (dai-shi) - Add: when using a non-implemented feature, mention exactly what it was that is not implemented in the error message. (papandreou)
0.6.5
- Fix: custom attributes whose names were the same as properties of
Object.prototype
, e.g."constructor"
, would confuse jsdom massively.
0.6.4
- Fix: CSS selectors which contain commas inside quotes are no longer misinterpreted. (chad3814)
- Add:
<img>
elements now fire"load"
events when theirsrc
attributes are changed. (kapouer)
0.6.3
- Fix: better automatic detection of URLs vs. HTML fragments when using
jsdom.env
. (jden)
0.6.2
- Fix: URL resolution to be amazing and extremely browser-compatible, including the interplay between the document's original URL, any
<base>
tags that were set, and any relativehref
s. This impacts many parts of jsdom having to do with external resources or accuratehref
andsrc
attributes. (deitch) - Add: access to frames and iframes via named properties. (adrianlang)
- Fix: node-canvas integration, which had been broken since 0.5.7.
0.6.1
- Make the code parseable with Esprima. (squarooticus)
- Use the correct
package.json
field"repository"
instead of"repositories"
to prevent npm warnings. (jonathanong)
0.6.0
Integrated a new HTML parser, htmlparser2, from fb55. This is an actively maintained and much less buggy parser, fixing many of our parsing issues, including:
- Parsing elements with optional closing tags, like
<p>
or<td>
. - The
innerHTML
of<script>
tags no longer cuts off the first character. - Empty attributes now have
""
as their value instead of the attribute name. - Multiline attributes no longer get horribly mangled.
- Attribute names can now be any value allowed by HTML5, including crazy things like
^
. - Attribute values can now contain any value allowed by HTML5, including e.g.
>
and<
.
0.5.7
- Fix: make event handlers attached via
on<event>
more spec-compatible, supportingreturn false
and passing theevent
argument. (adrianlang) - Fix: make the getter for
textContent
more accurate, e.g. in cases involving comment nodes or processing instruction nodes. (adrianlang) - Fix: make
<canvas>
behave like a<div>
when thenode-canvas
package isn't available, instead of crashing. (stepheneb)
0.5.6
- Fix:
on<event>
properties are correctly updated when usingsetAttributeNode
,attributeNode.value =
,removeAttribute
, andremoveAttributeNode
; before it only worked withsetAttribute
. (adrianlang) - Fix:
HTMLCollection
s now have named properties based on their members'id
andname
attributes, e.g.form.elements.inputId
is now present. (adrianlang)
0.5.5
- Fix:
readOnly
andselected
properties were not correct when their attribute values were falsy, e.g.<option selected="">
. (adrianlang)
0.5.4
This release, and all future releases, require at least Node.js 0.8.
- Add: parser can now be set via
jsdom.env
configuration. (xavi-) - Fix: accessing
rowIndex
for table rows that are not part of a table would throw. (medikoo) - Fix: several places in the code accidentally created global variables, or referenced nonexistant values. (xavi-)
- Fix:
<img>
elements'src
properties now evaluate relative tolocation.href
, just like<a>
elements'href
properties. (brianmaissy)
0.5.3
This release is compatible with Node.js 0.6, whereas all future releases will require at least Node.js 0.8.
- Fix:
getAttributeNS
now returnsnull
for attributes that are not present, just likegetAttribute
. (mbostock) - Change:
"request"
dependency pinned to version 2.14 for Node.js 0.6 compatibility.
0.5.2
- Fix: stylesheets with
@-webkit-keyframes
rules were crashing calls togetComputedStyle
. - Fix: handling of
features
option tojsdom.env
. - Change: retain the value of the
style
attribute until the element'sstyle
property is touched. (papandreou)
0.5.1
- Fix:
selectedIndex
now changes correctly in response to<option>
elements being selected. This makes<select>
elements actually work like you would want, especially with jQuery. (xcoderzach) - Fix:
checked
works correctly on radio buttons, i.e. only one can be checked and clicking on one does not uncheck it. Previously they worked just like checkboxes. (xcoderzach) - Fix:
click()
on<input>
elements now fires a click event. (xcoderzach)
0.5.0
- Fix: Make
contextify
a non-optional dependency. jsdom never worked without it, really, so this just caused confusion.
0.4.2
- Fix:
selected
now returns true for the first<option>
in a<select>
if nothing is explicitly set. - Fix: tweaks to accuracy and speed of the
querySelectorAll
implementation.
0.4.1 (hotfix)
- Fix: crashes when loading HTML files with
<a>
tags with nohref
attribute. (eleith)
0.4.0
- Fix:
getAttribute
now returnsnull
for attributes that are not present, as per DOM4 (but in contradiction to DOM1 through DOM3). - Fix: static
NodeList
-returning methods (such asquerySelectorAll
) now return a realNodeList
instance. - Change:
NodeList
s no longer expose nonstandard properties to the world, liketoArray
, without first prefixing them with an underscore. - Change:
NodeList
s no longer inconsistently have array methods. Previously, live node lists would haveindexOf
, while static node lists would have them all. Now, they have no array methods at all, as is correct per the specification.
0.3.4
- Fix: stylesheets with
@media
rules were crashing calls togetComputedStyle
, e.g. those in jQuery's initialization.
0.3.3
- Fix: make
document.write
calls insert new elements correctly. (johanoverip, kblomquist). - Fix:
<input>
tags with notype
attribute now return a default value of"text"
when callinginputEl.getAttribute("type")
.
0.3.2
- Fix: stylesheets with "joining" rules (i.e. those containing comma-separated selectors) now apply when using
getComputedStyle
. (chad3814, godmar) - Add: support for running the tests using @aredridel's html5 parser, as a prelude toward maybe eventually making this the default and fixing various parsing bugs.
0.3.1 (hotfix)
- Fix: crashes when invalid selectors were present in stylesheets.
0.3.0
- Fix: a real
querySelector
implementation, courtesy of the nwmatcher project, solves many outstandingquerySelector
bugs. - Add:
matchesSelector
, again via nwmatcher. - Add: support for styles coming from
<style>
and<link rel="stylesheet">
elements being applied to the results ofwindow.getComputedStyle
. (chad3814) - Add: basic implementation of
focus()
andblur()
methods on appropriate elements. More work remains. - Fix: script filenames containing spaces will now work when passed to
jsdom.env
. (TomNomNom) - Fix: elements with IDs
toString
,hasOwnProperty
, etc. could cause lots of problems. - Change: A window's
load
event always fires asynchronously now, even if no external resources are necessary. - Change: turning off mutation events is not supported, since doing so breaks external-resource fetching.
0.2.19
- Fix: URL resolution was broken on pages that included
href
-less<base>
tags. - Fix: avoid putting
attr
in the global scope when using node-canvas. (starsquare) - Add: New
SkipExternalResources
feature accepts a regular expression. (fgalassi)
0.2.18
- Un-revert: cssstyle has fixed its memory problems, so we get back accurate
cssText
andstyle
properties again.
0.2.17 (hotfix)
- Revert: had to revert the use of the cssstyle package.
cssText
andstyle
properties are no longer as accurate. - Fix: cssstyle was causing out-of-memory errors on some larger real-world pages, e.g. reddit.com.
0.2.16
- Update: Sizzle version updated to circa September 2012.
- Fix: when setting a text node's value to a falsy value, convert it to a string instead of coercing it to
""
. - Fix: Use the cssstyle package for
CSSStyleDeclaration
, giving much more accuratecssText
andstyle
properties on all elements. (chad3814) - Fix: the
checked
property on checkboxes and radiobuttons now reflects the attribute correctly. - Fix:
HTMLOptionElement
'stext
property should return the option's text, not its value. - Fix: make the
name
property only exist on certain specific tags, and accurately reflect the correspondingname
attribute. - Fix: don't format
outerHTML
(especially important for<pre>
elements). - Fix: remove the
value
property fromText
instances (e.g. text nodes). - Fix: don't break in the presence of a
String.prototype.normalize
method, like that of sugar.js. - Fix: include level3/xpath correctly.
- Fix: many more tests passing, especially related to file:/// URLs on Windows. Tests can now be run with
npm test
.
0.2.15
- Fix: make sure that doctypes don't get set as the documentElement (Aria Stewart)
- Add: HTTP proxy support for jsdom.env (Eugene Ware)
- Add: .hostname and .pathname properties to Anchor elements to comply with WHATWG standard (Avi Deitcher)
- Fix: Only decode HTML entities in text when not inside a
<script>
or<style>
tag. (Andreas Lind Petersen) - Fix: HTMLSelectElement single selection implemented its type incorrectly as 'select' instead of 'select-one' (John Roberts)
0.2.14
- Fix: when serializing single tags use ' />' instead of '/>' (kapouer)
- Fix: support for contextify simulation using vm.runInContext (trodrigues)
- Fix: allow jsdom.env's config.html to handle file paths which contain spaces (shinuza)
- Fix: Isolate QuerySelector from prototype (Nao Iizuka)
- Add: setting textContent to '' or clears children (Jason Davies)
- Fix: jsdom.env swallows exceptions that occur in the callback (Xavi)
0.2.13
- Fix: remove unused style property which was causing explosions in 0.2.12 and node 0.4.7
0.2.12
- Fix: do not include gmon.out/v8.log/tests in npm distribution
0.2.11
- Add: allow non-unique element ids (Avi Deitcher)
- Fix: make contexify an optional dependency (Isaac Schlueter)
- Add: scripts injected by jsdom are now marked with a 'jsdom' class for serialization's sake (Peter Lyons)
- Fix: definition for ldquo entity (Andrew Morton)
- Fix: access NamedNodeMap items via property (Brian McDaniel)
- Add: upgrade sizzle from 1.0 to fe2f6181 which is roughly 1.5.1
- Add: documentation now includes
jsdom.level(x, 'feature')
- Fix: make
toArray
anditem
onNodeList
objects non-enumerable properties - Add: a reference to
window.close
in the readme - Fix: Major performance boost (Felix Gnass)
- Fix: Using querySelector
:not()
throws aReferenceError
(Felix Gnass)
0.2.10
- Fix: problems with lax dependency versions
- Fix: CSSOM constructors are hung off of the dom (Brian McDaniel)
- Fix: move away from deprecated 'sys' module
- Fix: attribute event handlers on bubbling path aren't called (Brian McDaniel)
- Fix: setting textarea.value to markup should not be parsed (Andreas Lind Petersen)
- Fix: content of script tags should not be escaped (Ken Sternberg)
- Fix: DocumentFeatures for iframes with no src attribute. (Brian McDaniel) Closes #355
- Fix: 'trigger' to 'raise' to be a bit more descriptive
- Fix: When
ProcessExternalResources['script']
is disabled, do not run inline event handlers. #355 - Add: verbose flag to test runner (to show tests as they are running and finishing)
0.2.9
- Fix: ensure features are properly reset after a jsdom.env invocation. Closes #239
- Fix: ReferenceError in the scanForImportRules helper function
- Fix: bug in appendHtmlToElement with HTML5 parser (Brian McDaniel)
- Add: jsonp support (lheiskan)
- Fix: for setting script element's text property (Brian McDaniel)
- Fix: for jsdom.env src bug
- Add: test for jsdom.env src bug (multiple done calls)
- Fix: NodeList properties should enumerate like arrays (Felix Gnass)
- Fix: when downloading a file, include the url.search in file path
- Add: test for making a jsonp request with jquery from jsdom window
- Add: test case for issue #338
- Fix: double load behavior when mixing jsdom.env's
scripts
andsrc
properties (cjroebuck)
0.2.8 (hotfix)
- Fix: inline event handlers are ignored by everything except for the javascript context
0.2.7 (hotfix)
- Fix stylesheet loading
0.2.6
- Add: support for window.location.search and document.cookie (Derek Lindahl)
- Add: jsdom.env now has a document configuation option which allows users to change the referer of the document (Derek Lindahl)
- Fix: allow users to use different jsdom levels in the same process (sinegar)
- Fix: removeAttributeNS no longer has a return value (Jason Davies)
- Add: support for encoding/decoding all html entities from html4/5 (papandreou)
- Add: jsdom.env() accepts the same features object seen in jsdom.jsdom and friends
0.2.5
- Fix: serialize special characters in Element.innerHTML/Element.attributes like a grade A browser (Jason Priestley)
- Fix: ensure Element.getElementById only returns elements that are attached to the document
- Fix: ensure an Element's id is updated when changing the nodeValue of the 'id' attribute (Felix Gnass)
- Add: stacktrace to error reporter (Josh Marshall)
- Fix: events now bubble up to the window (Jason Davies)
- Add: initial window.location.hash support (Josh Marshall)
- Add: Node#insertBefore should do nothing when both params are the same node (Jason Davies)
- Add: fixes for DOMAttrModified mutation events (Felix Gnass)
0.2.4
- Fix: adding script to invalid/incomplete dom (document.documentElement) now catches the error and passes it in the
.env
callback (Gregory Tomlinson) - Cleanup: trigger and html tests
- Add: support for inline event handlers (ie:
<div onclick='some.horrible.string()'>
) (Brian McDaniel) - Fix: script loading over https (Brian McDaniel) #280
- Add: using style.setProperty updates the style attribute (Jimmy Mabey).
- Add: invalid markup is reported as an error and attached to the associated element and document
- Fix: crash when setChild() failes to create new DOM element (John Hurliman)
- Added test for issue #287.
- Added support for inline event handlers.
- Moved frame tests to test/window/frame.js and cleaned up formatting.
- Moved script execution tests to test/window/script.js.
- Fix a crash when setChild() fails to create a new DOM element
- Override CSSOM to update style attribute
0.2.3
- Fix: segfault due to window being garbage collected prematurely NOTE: you must manually close the window to free memory (window.close())
0.2.2
- Switch to Contextify to manage the window's script execution.
- Fix: allow nodelists to have a length of 0 and toArray to return an empty array
- Fix: style serialization; issues #230 and #259
- Fix: Incomplete DOCTYPE causes JavaScript error
- Fix: indentation, removed outdated debug code and trailing whitespace.
- Prevent JavaScript error when parsing incomplete
<!DOCTYPE>
. Closes #259. - Adding a test from brianmcd that ensures that setTimeout callbacks execute in the context of the window
- Fixes issue 250: make
document.parentWindow === window
work - Added test to ensure that timer callbacks execute in the window context.
- Fixes 2 issues in ResourceQueue
- Make frame/iframe load/process scripts if the parent has the features enabled
0.2.1
- Javascript execution fixes [#248, #163, #179]
- XPath (Yonathan and Daniel Cassidy)
- Start of cssom integration (Yonathan)
- Conversion of tests to nodeunit! (Martin Davis)
- Added sizzle tests, only failing 3/15
- Set the title node's textContent rather than its innerHTML #242. (Andreas Lind Petersen)
- The textContent getter now walks the DOM and extract the text properly. (Andreas Lind Petersen)
- Empty scripts won't cause jsdom.env to hang #172 (Karuna Sagar)
- Every document has either a body or a frameset #82. (Karuna Sagar)
- Added the ability to grab a level by string + feature. ie: jsdom.level(2, 'html') (Aria Stewart)
- Cleaned up htmlencoding and fixed character (de)entification #147, #177 (Andreas Lind Petersen)
- htmlencoding.HTMLDecode: Fixed decoding of
<
,>
,&
, and'
. Closes #147 and #177. - Require dom level as a string or object. (Aria Stewart)
- JS errors ar triggered on the script element, not document. (Yonathan)
- Added configuration property 'headers' for HTTP request headers. (antonj)
- Attr.specified is readonly - Karuna Sagar
- Removed return value from setAttributeNS() #207 (Karuna Sagar)
- Pass the correct script filename to runInContext. (robin)
- Add http referrer support for the download() function. (Robin)
- First attempt at fixing the horrible memory leak via window.stopTimers() (d-ash)
- Use vm instead of evals binding (d-ash)
- Add a way to set the encoding of the jsdom.env html request.
- Fixed various typos/lint problems (d-ash)
- The first parameter download is now the object returned by URL.parse(). (Robin)
- Fixed serialization of elements with a style attribute.
- Added src config option to jsdom.env() (Jerry Sievert)
- Removed dead code from getNamedItemNS() (Karuna Sagar)
- Changes to language/javascript so jsdom would work on v0.5.0-pre (Gord Tanner)
- Correct spelling of "Hierarchy request error" (Daniel Cassidy)
- Node and Exception type constants are available in all levels. (Daniel Cassidy)
- Use \n instead of \r\n during serialization
- Fixed auto-insertion of body/html tags (Adrian Makowski)
- Adopt unowned nodes when added to the tree. (Aria Stewart)
- Fix the selected and defaultSelected fields of
option
element. - Yonathan - Fix: EventTarget.getListeners() now returns a shallow copy so that listeners can be safely removed while an event is being dispatched. (Felix Gnass)
- Added removeEventListener() to DOMWindow (Felix Gnass)
- Added the ability to pre-load scripts for jsdom.env() (Jerry Sievert)
- Mutation event tests/fixes (Felix Gnass)
- Changed HTML serialization code to (optionally) pretty print while traversing the tree instead of doing a regexp-based postprocessing. (Andreas Lind Petersen)
- Relative and absolute urls now work as expected
- setNamedItem no longer sets Node.parentNode #153 (Karuna Sagar)
- Added missing semicolon after entity name - Felix Gnass
- Added NodeList#indexOf implementation/tests (Karuna Sagar)
- resourceLoader.download now works correctly with https and redirects (waslogic)
- Scheme-less URLs default to the current protocol #87 (Alexander Flatter)
- Simplification the prevSibling(), appendChild(), insertBefore() and replaceChild() code (Karuna Sagar)
- Javascript errors use core.Node.trigger (Alexander Flatter)
- Add core.Document.trigger in level1/core and level2/events; Make DOMWindow.console use it (Alexander Flatter)
- Resource resolver fixes (Alexander Flatter)
- Fix serialization of doctypes with new lines #148 (Karuna Sagar)
- Child nodes are calculated immediately instead of after .length is called #169, #171, #176 (Karuna Sagar)