# local-access [![CI](https://github.com/lukeed/local-access/workflows/CI/badge.svg)](https://github.com/lukeed/local-access/actions?query=workflow%3ACI) [![codecov](https://badgen.net/codecov/c/github/lukeed/local-access)](https://codecov.io/gh/lukeed/local-access)
> Retrieve formatted URL addresses for local and LAN access.
## Install
```
$ npm install local-access --save-dev
```
## Usage
```js
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`](https://nodejs.org/api/url.html#url_url_format_urlobject), which means its `options` are inherited.
#### options
Type: `Object`
A [`URL`](https://nodejs.org/api/url.html#url_the_whatwg_url_api) 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`](https://nodejs.org/api/url.html#url_urlobject_hostname) -- added a default value.
#### options.port
Type: `Number` or `String`
Default: `process.env.PORT || 8080`
Same as [`urlObject.port`](https://nodejs.org/api/url.html#url_urlobject_port) -- added a default value.
## License
MIT © [Luke Edwards](https://lukeed.com)