Skip to content

Retrieve formatted URL addresses for local and LAN access.

License

Notifications You must be signed in to change notification settings

lukeed/local-access

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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:'https://localhost:8080', network:'https://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:'https://localhost:8080/foo/bar', network:'https://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