Disposable HTTP server.
We believe in a future in which the web is a preferred environment for numerical computation. To help realize this future, we’ve built stdlib. stdlib is a standard library, with an emphasis on numerical and scientific computation, written in JavaScript (and C) for execution in browsers and in Node.js.
The library is fully decomposable, being architected in such a way that you can swap out and mix and match APIs and functionality to cater to your exact preferences and use cases.
When you use stdlib, you can be absolutely certain that you are using the most thorough, rigorous, well-written, studied, documented, tested, measured, and high-quality code out there.
To join us in bringing numerical computing to the web, get started by checking us out on GitHub, and please consider financially supporting stdlib. We greatly appreciate your continued support!
[![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url]
Create a disposable HTTP server.
bash
npm install @stdlib/net-disposable-http-serverjavascript
var httpServer = require( '@stdlib/net-disposable-http-server' );javascript
var opts = {
'html': '<script src="/bundle.js"></script>',
'javascript': 'console.log( "Boop" );'
};
httpServer( opts );buffer or string to serve as HTML content.buffer or string to serve as JavaScript.0 (i.e., randomly assigned).=port."0.0.0.0".boolean indicating whether to launch a web browser. Default: false.html option. Once the content is requested, the server will close.javascript
var opts = {
'html': '<h1>Beep</h1>'
};
httpServer( opts );javascript option. If no HTML is provided, an HTML boilerplate is served and the JavaScript is served as /bundle.js. Once the content is requested, the server will close.javascript
var opts = {
'javascript': 'console.log( "Boop" );'
};
httpServer( opts );/bundle.js.javascript
var opts = {
'html': '<script src="/bundle.js"></script>',
'javascript': 'console.log( "Boop" );'
};
httpServer( opts );server handle, provide a callback.javascript
var nextTick = require( '@stdlib/utils-next-tick' );
function onReady( error, server ) {
if ( error ) {
throw error;
}
nextTick( close );
function close() {
server.close();
}
}
var opts = {
'html': html,
'javascript': 'console.log( "Boop" );'
};
httpServer( opts, onReady );html or javascript option is set, the server serves an HTML boilerplate and then closes.javascript
var join = require( 'path' ).join;
var readFileSync = require( '@stdlib/fs-read-file' ).sync;
var httpServer = require( '@stdlib/net-disposable-http-server' );
var html = join( __dirname, 'examples', 'fixtures', 'index.html' );
var js = join( __dirname, 'examples', 'fixtures', 'script.js' );
var opts = {
'html': readFileSync( html ),
'javascript': readFileSync( js ),
'port': 7331,
'hostname': 'localhost',
'open': false
};
httpServer( opts, clbk );
function clbk( error, server ) {
if ( error ) {
throw error;
}
// Give the user a few seconds to open her web browser before closing the server...
setTimeout( onTimeout, 5000 );
function onTimeout() {
server.close();
}
}bash
npm install -g @stdlib/net-disposable-http-server-clitext
Usage: temp-http-server [options] (--html path | --js path | --stdin type)
Options:
-h, --help Print this message.
-V, --version Print the package version.
--html path Serve HTML.
--js, --javascript path Serve JavaScript.
--stdin type Type of content: html or javascript.
-p, --port port Server port. Default: 0.
--maxport maxport Max server port. Default: `port`.
--hostname hostname Server hostname.
--address address Server address. Default: 0.0.0.0.
--open Launch a browser once server is ready.DEBUG: enable verbose logging.PORT: server port.MAXPORT: max server port.HOSTNAME: server hostname.ADDRESS: server address.--html or --javascript command-line flag is set, stdin is assumed to be of the other type. Accordingly, the --stdin flag may be omitted.bash
$ DEBUG=* temp-http-server --html ./examples/fixtures/index.html
...bash
$ DEBUG=* temp-http-server --javascript ./examples/fixtures/script.js
...bash
$ cat ./examples/fixtures/index.html | DEBUG=* temp-http-server --port 7331 --stdin html
...bash
$ cat ./examples/fixtures/index.html | DEBUG=* temp-http-server --port 7331 --javascript ./examples/fixtures/script.js
...bash
$ cat ./examples/fixtures/script.js | DEBUG=* temp-http-server --address '127.0.0.1' --stdin javascript
.../bundle.js file,bash
$ cat ./examples/fixtures/script.js | DEBUG=* temp-http-server --html ./examples/fixtures/index.html
...
