Usage

`javascript
var http2ServerFactory = require( '@stdlib/net-http2-secure-server' );
`

#### http2ServerFactory( options\[, requestListener] )

Returns a function to create an [HTTP/2][nodejs-http2] server.

`javascript
var resolve = require( 'path' ).resolve;
var readFileSync = require( '@stdlib/fs-read-file' ).sync;

var opts = {
'cert': readFileSync( resolve( __dirname, 'examples', 'localhost-cert.pem' ) ),
'key': readFileSync( resolve( __dirname, 'examples', 'localhost-privkey.pem' ) )
};
var http2Server = http2ServerFactory( opts );
`

The function supports the following parameters:

- options: options.
- requestListener: callback to invoke upon receiving an HTTP request (_optional_).

To bind a request callback to a server, provide a requestListener.

`javascript
var resolve = require( 'path' ).resolve;
var readFileSync = require( '@stdlib/fs-read-file' ).sync;

function requestListener( request, response ) {
console.log( request.url );
response.end( 'OK' );
}

var opts = {
'cert': readFileSync( resolve( __dirname, 'examples', 'localhost-cert.pem' ) ),
'key': readFileSync( resolve( __dirname, 'examples', 'localhost-privkey.pem' ) )
};
var http2Server = http2ServerFactory( opts, requestListener );
`

In addition to the options supported by [http2.createSecureServer][nodejs-http2-create-secure-server], the function accepts the following options:

- port: server port. Default: 0 (i.e., randomly assigned).
- maxport: max server port when port hunting. Default: maxport=port.
- hostname: server hostname.
- address: server address. Default: 127.0.0.1.

To specify server options, provide an options object.

`javascript
var resolve = require( 'path' ).resolve;
var readFileSync = require( '@stdlib/fs-read-file' ).sync;

var opts = {
'port': 7331,
'address': '0.0.0.0',
'cert': readFileSync( resolve( __dirname, 'examples', 'localhost-cert.pem' ) ),
'key': readFileSync( resolve( __dirname, 'examples', 'localhost-privkey.pem' ) )
};

var http2Server = http2ServerFactory( opts );
`

To specify a range of permissible ports, set the maxport option.

`javascript
var resolve = require( 'path' ).resolve;
var readFileSync = require( '@stdlib/fs-read-file' ).sync;

var opts = {
'maxport': 9999,
'cert': readFileSync( resolve( __dirname, 'examples', 'localhost-cert.pem' ) ),
'key': readFileSync( resolve( __dirname, 'examples', 'localhost-privkey.pem' ) )
};

var http2Server = http2ServerFactory( opts );
`

When provided a maxport option, a created server will search for the first available port on which to listen, starting from port.

#### http2Server( done )

Creates an [HTTP/2][nodejs-http2] server.

`javascript
var resolve = require( 'path' ).resolve;
var readFileSync = require( '@stdlib/fs-read-file' ).sync;

function done( error, server ) {
if ( error ) {
throw error;
}
console.log( 'Success!' );
server.close();
}

var opts = {
'cert': readFileSync( resolve( __dirname, 'examples', 'localhost-cert.pem' ) ),
'key': readFileSync( resolve( __dirname, 'examples', 'localhost-privkey.pem' ) )
};
var http2Server = http2ServerFactory( opts );

http2Server( done );
`

The function supports the following parameters:

- done: callback to invoke once a server is listening and ready to handle requests.