xhr2

WebJar for xhr2

License	MIT
GroupId	org.webjars.npm
ArtifactId	xhr2
Last Version	0.2.0
Release Date	Oct 8, 2020
Type	jar
Description	xhr2 WebJar for xhr2
Project URL	https://www.webjars.org
Source Code Management	https://github.com/pwnall/node-xhr2

Download xhr2

Filename	Size
xhr2-0.2.0.pom
xhr2-0.2.0.jar	38 KB
xhr2-0.2.0-sources.jar	22 bytes
xhr2-0.2.0-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/xhr2/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>xhr2</artifactId>
    <version>0.2.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/xhr2/
implementation 'org.webjars.npm:xhr2:0.2.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/xhr2/
implementation ("org.webjars.npm:xhr2:0.2.0")

Apache Buildr

'org.webjars.npm:xhr2:jar:0.2.0'

Apache Ivy

<dependency org="org.webjars.npm" name="xhr2" rev="0.2.0">
  <artifact name="xhr2" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='xhr2', version='0.2.0')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "xhr2" % "0.2.0"

Leiningen

[org.webjars.npm/xhr2 "0.2.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

XMLHttpRequest Emulation for node.js

This is an npm package that implements the W3C XMLHttpRequest specification on top of the node.js APIs.

Supported Platforms

This library is tested against the following platforms.

• node.js 10
• node.js 12

Keep in mind that the versions above are not hard requirements.

Installation and Usage

The preferred installation method is to add the library to the dependencies section in your package.json.

{
  "dependencies": {
    "xhr2": "*"
  }
}

Alternatively, npm can be used to install the library directly.

npm install xhr2

Once the library is installed, require-ing it returns the XMLHttpRequest constructor.

var XMLHttpRequest = require('xhr2');

The other objects that are usually defined in an XHR environment are hanging off of XMLHttpRequest.

var XMLHttpRequestUpload = XMLHttpRequest.XMLHttpRequestUpload;

MDN (the Mozilla Developer Network) has a great intro to XMLHttpRequest.

This library's CoffeeDocs can be used as quick reference to the XMLHttpRequest specification parts that were implemented.

Features

The following standard features are implemented.

• http and https URI protocols
• Basic authentication according to the XMLHttpRequest specification
• request and response header management
• send() accepts the following data types: String, ArrayBufferView, ArrayBuffer (deprecated in the standard)
• responseType values: text, json, arraybuffer
• readystatechange and download progress events
• overrideMimeType()
• abort()
• timeout
• automated redirection following

The following node.js extensions are implemented.

• send() accepts a node.js Buffer
• Setting responseType to buffer produces a node.js Buffer
• nodejsSet does XHR network configuration that is not exposed in browsers, for security reasons

The following standard features are not implemented.

• FormData
• Blob
• file:// URIs
• data: URIs
• upload progress events
• synchronous operation
• Same-origin policy checks and CORS
• cookie processing

Versioning

The library aims to implement the W3C XMLHttpRequest specification, so the library's API will always be a (hopefully growing) subset of the API in the specification.

Development

The following commands will get the source tree in a node-xhr2/ directory and build the library.

git clone git://github.com/pwnall/node-xhr2.git
cd node-xhr2
npm install
npm pack

Installing CoffeeScript globally will let you type cake instead of node_modules/.bin/cake

npm install -g coffeescript

The library comes with unit tests that exercise the XMLHttpRequest API.

cake test

The tests themselves can be tested by running them in a browser environment, where a different XMLHttpRequest implementation is available. Both Google Chrome and Firefox deviate from the specification in small ways, so it's best to run the tests in both browsers and mentally compute an intersection of the failing tests.

cake webtest
BROWSER=firefox cake webtest

Copyright and License

The library is Copyright (c) 2013 Victor Costan, and distributed under the MIT License.

Versions

Version
0.2.0 Oct 8, 2020
0.1.4 Oct 25, 2017
0.1.3 May 29, 2016