npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@audc/xhr2

v0.2.4

Published

XMLHttpRequest emulation for node.js

Downloads

580

Readme

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.

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.