浏览器请求：最简单的HTTP库

1. 安装指南

首先，您需要在Node项目中安装browser-request。可以通过以下命令完成：

$ npm install browser-request

2. 项目的使用说明

Browser Request是Node.js中著名的request库的浏览器版本。它提供了一个简洁的API，使您能够在浏览器中执行HTTP请求。

以下是一些基本的用法示例：

获取资源

request('/some/resource.txt', function(er, response, body) {
  if(er)
    throw er;
  console.log("我得到: " + body);
})

发送资源

request.put({uri:'/some/resource.xml', body:'<foo><bar/></foo>'}, function(er, response) {
  if(er)
    throw new Error("XML PUT失败 (" + er + "): HTTP状态为 " + response.status);
  console.log("存储了XML");
})

处理JSON

request({method:'POST', url:'/db', body:'{"relaxed":true}', json:true}, on_response)

function on_response(er, response, body) {
  if(er)
    throw er
  if(result.ok)
    console.log('服务器正常，id = ' + result.id)
}

或者，使用简写版本（直接将数据传递到json选项中）：

request({method:'POST', url:'/db', json:{relaxed:true}}, on_response)

方便的CouchDB

Browser Request提供了一个CouchDB包装器。它与JSON包装器相同，但如果HTTP请求成功，但在数据库级别出现问题，则会指示错误。最常见的例子是409 Conflict。

request.couch({method:'PUT', url:'/db/existing_doc', body:{"will_conflict":"你打赌!"}}, function(er, resp, result) {
  if(er.error === 'conflict')
    return console.error("Couch说不行: " + er.reason); // 输出: Couch说不行: Document update conflict.

  if(er)
    throw er;

  console.log("现有文档已存储。这一定是第一次运行。");
})

3. 项目API使用文档

Browser Request的API与Node.js中的request库类似，但在浏览器中不可用的部分除外。以下是API的基本使用方法：

• request(url, [options], callback): 发起一个HTTP请求。
• request.put(options, callback): 发起一个PUT请求。
• request.post(options, callback): 发起一个POST请求。
• request.get(options, callback): 发起一个GET请求。
• request.head(options, callback): 发起一个HEAD请求。
• request.delete(options, callback): 发起一个DELETE请求。
• request.couch(options, callback): 发起一个针对CouchDB的请求。

更多详细信息和示例，请查看Node.js Request README。

4. 项目安装方式

除了通过npm安装外，您也可以通过browserify在浏览器中使用Browser Request。

首先，在Node项目中添加browser-request：

$ npm install browser-request

然后，创建一个使用browser-request的模块。

// example.js - 使用browser-request的前端示例代码
var request = require('browser-request')
request('/', function(er, res) {
  if(!er)
    return console.log('browser-request获取了您的根路径:\n' + res.body)

  console.log('有一个错误，但至少browser-request加载并运行了！')
  throw er
})

为了在浏览器中构建这个模块，通过browserify运行它：

$ browserify --entry example.js --outfile example-built.js

将example-built.js部署到您的网站，并在页面中使用它：

<script src="example-built.js"></script> <!-- 运行请求，将结果输出到控制台 -->

Browser Request遵循Apache 2.0许可。