# request-hostname

> Get a proper hostname off of a request object

Latest version **1.0.0** (published 2017-05-17) · ISC license · 0 weekly downloads

## Install

```sh
npm install request-hostname
pnpm add request-hostname
yarn add request-hostname
bun add request-hostname
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2017-05-17 |
| First published | 2017-05-17 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Wes Todd |
| Maintainers | wesleytodd |
| Keywords | request, hostname, host header, http host, host |

## Links

- npm: https://www.npmjs.com/package/request-hostname
- npm.io page: https://npm.io/package/request-hostname

## Alternatives

- [launchdarkly-js-client-sdk](https://npm.io/package/launchdarkly-js-client-sdk.md) — 2.5M weekly downloads
- [@elastic/elasticsearch](https://npm.io/package/@elastic/elasticsearch.md) — 2.1M weekly downloads
- [@c8y/client](https://npm.io/package/@c8y/client.md) — 15.3K weekly downloads
- [@signaldb/maverickjs](https://npm.io/package/@signaldb/maverickjs.md) — 1.7K weekly downloads
- [@bbc/http-transport-cache](https://npm.io/package/@bbc/http-transport-cache.md) — 1.2K weekly downloads

## Recent versions

- 1.0.0 (latest) — 2017-05-17

## README

# Request Hostname

[![NPM Version][npm-image]][npm-url]
[![NPM Downloads][downloads-image]][downloads-url]
[![Build Status](https://travis-ci.org/wesleytodd/request-hostname.svg?branch=master)](https://travis-ci.org/wesleytodd/request-hostname)
[![js-happiness-style](https://img.shields.io/badge/code%20style-happiness-brightgreen.svg)](https://github.com/JedWatson/happiness)

[npm-image]: https://img.shields.io/npm/v/request-hostname.svg
[npm-url]: https://npmjs.org/package/request-hostname
[downloads-image]: https://img.shields.io/npm/dm/request-hostname.svg
[downloads-url]: https://npmjs.org/package/request-hostname

Get the hostname from a request object.  Even if it is IPv6 or from `x-forwarded-host`.

## Install

```
$ npm install --save request-hostname
```

## Usage

```javascript
// Basic stuff
var requestHostname = require('request-hostname');
console.log(requestHostname(req)) // example.com

// Anything that looks like a standard node request object
var request = {
  headers: {
    host: 'www.example.com'
  }
};
console.log(requestHostname(request)) // www.example.com

// Also IPv6 or IPv4 hosts
var IPv6Request = {
  headers: {
    host: '[2001:0db8:0000:0000:0000:ff00:0042:8329]'
  }
};
console.log(requestHostname(IPv6Request)) // 2001:0db8:0000:0000:0000:ff00:0042:8329
```

---
_Source: https://npm.io/package/request-hostname · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
