分类标签归档:Node.js

Node.js api 中文文档 - HTTPS


稳定度: 2 - 稳定

HTTPS是建立在TLS/SSL之上的HTTP协议。在node.js中,它被作为单独模块实现。

Class: https.Server

这个类是tls.Server的子类,并且和http.Server触发相同的事件。更多信息请参阅http.Server

server.setTimeout(msecs, callback)

参阅http.Server#setTimeout()

server.timeout

参阅http.Server#timeout

https.createServer(options[, requestListener])

返回一个新的HTT...

阅读全文...

Node.js api 中文文档 - HTTP


稳定度: 2 - 稳定

你必须通过require('http')来使用HTTP服务器和客户端。

node.js中的HTTP接口被设置来支持许多HTTP协议里原本用起来很困难的特性。特别是大且成块的有编码的消息。这个接口从不缓冲整个请求或响应。用户可以对它们使用流。

HTTP消息头可能是一个类似于以下例子的对象:

{ 'content-length': '123',
  'content-type': 'text/plain',
  'connection': 'keep-alive',
  &...

阅读全文...

Node.js api 中文文档 - Global Objects


这些对象是所有模块都可用的。其中的一些对象不是真正的在全局作用域内,而是在模块作用域内 - 它将会在文档中被指出。

global

  • {Object} 全局命名空间对象。

在浏览器,顶级作用域是全局作用域。这意味着在浏览器的全局作用域中,你创建了一个对象那么就是定义了一个全局对象。在node.js中是不同的,顶级作用域不是全局作用域,在node.js的模块中创建的对象只属于那个模块。

process

  • {Object}

进程对象。参阅process章节。

console

  • {Object}

被用来向stdoutstderr打印信息。参阅console章节。

Class: Buffe...

阅读全文...

Node.js api 中文文档 - File System


稳定度: 2 - 稳定

文件I/O是由标准POSIX函数的简单包装提供的。通过require('fs')来使用这个模块。所有的方法都有异步和同步两种形式。

异步形式的方法通常在最后一个参数上接受一个回调函数。回调函数的参数则取决于不同的方法,但是第一个参数总是为异常所保留。如果操作正常结束,那么第一个参数会是nullundefined

当同步形式的方法产生异常时,会立刻抛出。你可以使用try/catch捕获,或让它们冒泡。

下面是一个异步方法的例子:

var fs = require('fs');

fs.unlink('/tmp/hello', fu...

阅读全文...

Node.js api 中文文档 - Events


稳定度: 2 - 稳定

node.js中的许多对象触发事件:一个net.Server每次被连接时触发事件,一个fs.readStream当文件打开时触发事件。所有触发事件的对象都是events.EventEmitter的实例。你可以通过require("events");来取得这个模块。

通常,事件名以驼峰字符串来命令,但是这不是严格要求的,任何字符串都是可以接受的。

为了处理触发的事件,我们将函数关联到对象上。这些函数被称为监听器。在监听器中,this指向监听器所关联的EventEmitter实例。

Class: events.EventEmitter

使用require('event...

阅读全文...

Node.js api 中文文档 - Errors


node.js生成的错误分为两类:JavaScript错误和系统错误。所有的错误都继承于JavaScriptError类,或就是它的实例。并且都至少提供这个类中可用的属性。

当一个操作因为语法错误或语言运行时级别(language-runtime-level)的原因不被允许时,一个JavaScript error会被生成并抛出一个异常。如果一个操作因为系统级别(system-level)限制而不被允许时,一个系统错误会被生成。客户端代码接着会根据API传播它的方式来被给予捕获这个错误的机会。

API被调用的风格决定了生成的错误如何回送(handed back),传播给客户端。这反过来告...

阅读全文...

Node.js api 中文文档 - DNS


稳定度: 2 - 稳定

通过require('dns')来获取这个模块。

这个模块包含以下两类函数:

1) 使用底层操作系统工具来进行域名解析的函数,并且不需要进行任何网络活动。这类函数只有一个:dns.lookup。希望与 在其他操作系统的其他应用 执行域名解析 有相同行为时,请使用dns.lookup

下面是一个解析www.google.com的例子:

var dns = require('dns');

dns.lookup('www.google.com', function onLookup(err, addresses, family) {
...

阅读全文...

Node.js api 中文文档 - Debugger


稳定度: 2 - 稳定

V8自带了一个强大的调试器,可以从外部通过TCP协议访问。node.js为这个调试器内建了一个客户端。要使用它的话,使用debug参数启动node.js;会出现提示符:

% iojs debug myscript.js
< debugger listening on port 5858
connecting... ok
break in /home/indutny/Code/git/indutny/myscript.js:1
  1 x = 5;
  2 setTimeout(function () {
  3   debugger;
debug>
...

阅读全文...

Node.js api 中文文档 - Crypto


稳定度: 2 - 稳定

使用require('crypto')来获取这个模块。

crypto模块提供了一种封装安全证书的方法,用来作为安全HTTPS网络和HTTP链接的一部分。

它也提供了一个OpenSSL hashhamccipherdeciphersignvierify方法的包装集合。

crypto.setEngine(engine[, flags])

加载和设置 一些/所有 OpenSSL功能引擎(由标记选择)。

引擎可以通过id或 引擎共享库的路径 来选择。

flags是可选的,并且有一个ENGINE_METHOD_ALL默认值。可以选一个或多个以下的标记(在常量模块中...

阅读全文...

Node.js api 中文文档 - Console


稳定度: 2 - 稳定

这个模块定义了一个控制台类,并且暴露了一个console对象。

console对象是一个特殊的Console实例,它的输出被传至stdoutstderr

为了使用的方便,console被定义为一个全局对象,不需要通过require就可直接使用。

console

  • Object

用来向stdoutstderr打印信息。与大多数浏览器提供的console对象的功能类似,只是这里输出被传至stdoutstderr

当目的地是终端或文件时(为了避免过早退出丢失信息),console函数时同步的。当目的地是管道时(为了避免长时间阻塞),console函数时异步的...

阅读全文...