# scoped-http-client

> http client request wrapper

Latest version **0.11.0** (published 2015-06-05) · 0 weekly downloads

## Install

```sh
npm install scoped-http-client
pnpm add scoped-http-client
yarn add scoped-http-client
bun add scoped-http-client
```

## Health

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

Positive: has types package; no vulnerabilities.

Warnings: low downloads; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.11.0 |
| Published | 2015-06-05 |
| First published | 2011-08-01 |
| Weekly downloads | 0 |
| TypeScript types | separate (@types/scoped-http-client) |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 85 |
| Author | technoweenie |
| Maintainers | technoweenie, technicalpickles, keith_duncan, michaelansel |

## Links

- npm: https://www.npmjs.com/package/scoped-http-client
- Repository: https://github.com/technoweenie/node-scoped-http-client
- Issues: https://github.com/technoweenie/node-scoped-http-client/issues
- npm.io page: https://npm.io/package/scoped-http-client

## Recent versions

- 0.11.0 (latest) — 2015-06-05
- 0.10.3 — 2015-01-27
- 0.10.2 — 2015-01-08
- 0.10.1 — 2015-01-08
- 0.10.0 — 2014-11-19
- 0.9.8 — 2013-02-26
- 0.9.7 — 2012-04-15
- 0.9.6 — 2011-11-09
- 0.9.4 — 2011-10-25
- 0.9.3 — 2011-10-25
- 0.9.2 — 2011-10-25
- 0.9.1 — 2011-10-18
- 0.9.0 — 2011-08-01

## README

# Scoped HTTP Client for Node.js

[Node.js's HTTP client][client] is great, but a little too low level for 
common purposes.  It's common practice for some libraries to
extract this out so it's a bit nicer to work with.

[client]: http://nodejs.org/api/http.html#http_http_request_options_callback

```javascript
function(method, path, customHeaders, body, callback) {
  var client = http.createClient(url)
  client.request(method, path, headers)
  // ...
}
```

I hate functions with lots of optional arguments.  Let's turn that into:

```javascript
var scopedClient = require('./lib')
  , util         = require('util')

var client = scopedClient.create('https://api.github.com')
  .header('accept', 'application/json')
  .path('user/show/technoweenie')
  .get()(function(err, resp, body) {
    util.puts(body)
  })
```

You can scope a client to make requests with certain parameters without
affecting the main client instance:

```javascript
client.path('https://api.github.com') // reset path
client.scope('users/technoweenie', function(cli) {
  // cli's path is "https://api.github.com/users/technoweenie"
  cli.get()(function(err, resp, body) {
    util.puts(body)
  })
})

// client's path is back to just "https://api.github.com"
```

You can use `.post()`, `.put()`, `.del()`, and `.head()`.

```javascript
client.query({login:'technoweenie',token:'...'})
  .scope('users/technoweenie', function(cli) {
    var data = JSON.stringify({location: 'SF'})

    // posting data!
    cli.post(data)(function(err, resp, body) {
      util.puts(body)
    })
  })
```

Sometimes you want to stream the request body to the server.  The request 
is a standard [http.clientRequest][request].

```javascript
client.post(function (req) {
  req.write("...")
  req.write("...")
})(function(err, resp, body) {
  // ...
})
```

And other times, you want to stream the response from the server.  Simply 
listen for the request's response event yourself and omit the response 
callback.

```javascript
client.get(function (err, req) {
  // do your own thing
  req.addListener('response', function (resp) {
    resp.addListener('data', function (chunk) {
      util.puts("CHUNK: " + chunk)
    })
  })
})()
```

[request]: http://nodejs.org/api/http.html#http_class_http_clientrequest

Basic HTTP authentication is supported:

```javascript
client.get(function (err, req) {
  // we'll keep this conversation secret...
  req.auth('technoweenie', '...')
})
```

Adding simple timeout support:

	client = ScopedClient.create('http://10.255.255.1:9999');

	client.timeout(100);

	client.get()(function(err, resp, body) {
	  if (err) {
	    util.puts("ERROR: " + err);
	   }
	});


## Development

Run this in the main directory to compile coffeescript to javascript as you go:

    $ coffee -wc -o lib --no-wrap src/**/*.coffee


## Copyright

Copyright (c) 2014 rick. See LICENSE for details.

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