XMLHttpRequest for node.js
Перейти к файлу
Rosen Vladimirov ebd7658bd3 Merge pull request #1 from telerik/vladimirov/add-timeout
Add timeout option
2014-11-24 11:12:28 +02:00
example Move files around to better conform to CommonJS, updates to package.json 2012-02-19 20:00:25 -06:00
lib Add timeout option 2014-11-21 14:48:32 +02:00
tests Merge pull request #74 from matthewwithanm/301 2014-06-17 15:40:00 -05:00
LICENSE Add license 2012-12-18 07:32:19 -06:00
README.md Add license 2012-12-18 07:32:19 -06:00
autotest.watchr add test helper watchr script to automatically run tests 2010-06-16 18:43:17 +08:00
package.json ensure self.status is always a number, not a string... 2013-10-02 10:14:34 -07:00

README.md

node-XMLHttpRequest

node-XMLHttpRequest is a wrapper for the built-in http client to emulate the browser XMLHttpRequest object.

This can be used with JS designed for browsers to improve reuse of code and allow the use of existing libraries.

Note: This library currently conforms to XMLHttpRequest 1. Version 2.0 will target XMLHttpRequest Level 2.

Usage

Here's how to include the module in your project and use as the browser-based XHR object.

var XMLHttpRequest = require("xmlhttprequest").XMLHttpRequest;
var xhr = new XMLHttpRequest();

Note: use the lowercase string "xmlhttprequest" in your require(). On case-sensitive systems (eg Linux) using uppercase letters won't work.

Versions

Prior to 1.4.0 version numbers were arbitrary. From 1.4.0 on they conform to the standard major.minor.bugfix. 1.x shouldn't necessarily be considered stable just because it's above 0.x.

Since the XMLHttpRequest API is stable this library's API is stable as well. Major version numbers indicate significant core code changes. Minor versions indicate minor core code changes or better conformity to the W3C spec.

License

MIT license. See LICENSE for full details.

Supports

  • Async and synchronous requests
  • GET, POST, PUT, and DELETE requests
  • All spec methods (open, send, abort, getRequestHeader, getAllRequestHeaders, event methods)
  • Requests to all domains

Known Issues / Missing Features

For a list of open issues or to report your own visit the github issues page.

  • Local file access may have unexpected results for non-UTF8 files
  • Synchronous requests don't set headers properly
  • Synchronous requests freeze node while waiting for response (But that's what you want, right? Stick with async!).
  • Some events are missing, such as abort
  • getRequestHeader is case-sensitive
  • Cookies aren't persisted between requests
  • Missing XML support
  • Missing basic auth