local-access

Retrieve formatted URL addresses for local and LAN access.

Usage no npm install needed!

<script type="module">
  import localAccess from 'https://cdn.skypack.dev/local-access';
</script>

README

local-access CI codecov

Retrieve formatted URL addresses for local and LAN access.

Install

$ npm install local-access --save-dev

Usage

import localAccess from 'local-access';
// or
const localAccess = require('local-access');

localAccess();
//=> { local:'http://localhost:8080', network:'http://10.0.0.3:8080' }

localAccess({ https:true, port:3000 });
//=> { local:'https://localhost:3000', network:'https://10.0.0.3:3000' }

localAccess({ pathname:'foo/bar' });
//=> { local:'http://localhost:8080/foo/bar', network:'http://10.0.0.3:8080/foo/bar' }

API

localAccess(options)

Parsing and formatting is controlled by url.format, which means its options are inherited.

options

Type: Object

A URL instance, or any object with matching keys.

options.https

Type: Boolean
Default: false

Shortcut for determining the options.protocol value.

Note: This is the only config value unique to local-access!

options.hostname

Type: String
Default: 'localhost'

Same as urlObject.hostname -- added a default value.

options.port

Type: Number or String
Default: process.env.PORT || 8080

Same as urlObject.port -- added a default value.

License

MIT © Luke Edwards