Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

An adaptation of httpd.js for the Addon (Jetpack) SDK

branch: master
README.md

Provides a HTTP server written in JavaScript for the Mozilla platform, which can be used in unit tests.

The most basic usage is:

var {startServerAsync} = require("httpd")
var srv = startServerAsync(port, basePath);
require("unload").when(function cleanup() {
  srv.stop(function() { // ideally you should continue execution from this point.
  })
});

This starts a server in background (assuming you're running this code in an application that has an event loop, such as Firefox). The server listens at http://localhost:port/ and serves files from the specified directory. You can serve static content or use SJS scripts, as described in documentation on developer.mozilla.org.

You can also use nsHttpServer to start the server manually:

var {nsHttpServer} = require("httpd");
var srv = new nsHttpServer();
// further documentation on developer.mozilla.org

Example main.js and a simple unit test (test-httpd.js) are provided with this package. Try cfx run and cfx test.

See https://developer.mozilla.org/en/httpd.js/HTTP_server_for_unit_tests for general information.

Something went wrong with that request. Please try again.