Api changes between v0.8 and v0.10

When editing this page please be as detailed as possible. Examples are encouraged!

Changed

• Streams Interface

  • Readable, Writable, Duplex, and Transform base classes added.
  • Readable streams use a read() method instead of emitting 'data' events right away.
  • Adding a 'data' event handler, or calling pause() or resume() will switch into "old mode".
    • This means that data event handlers won't ever miss the first chunk if they're not added right away, and pause() is no longer merely advisory.
  • If you don't consume the data, then streams will sit in a paused state forever, and the end event will never happen.

• The uv_after_work_cb signature has changed to take a second integer argument indicating status. For backwards compatibility, explicitly cast the 4th argument to uv_queue_work. Example

• process.nextTick happens at the end of the current tick, immediately after the current stack unwinds. If you are currently using recursive nextTick calls, use setImmediate instead.

• -p --print command line switch implies -e --eval

• url: Parsed objects always have all properties, but unused ones are set to null. Example:

  // v0.8
  > url.parse('http://foo')
  { protocol: 'http:',
    slashes: true,
    host: 'foo',
    hostname: 'foo',
    href: 'http://foo/',
    pathname: '/',
    path: '/' }
  
  // 0.10
  > url.parse('http://foo')
  { protocol: 'http:',
    slashes: true,
    auth: null,
    host: 'foo',
    port: null,
    hostname: 'foo',
    hash: null,
    search: null,
    query: null,
    pathname: '/',
    path: '/',
    href: 'http://foo/' }

• Domain-added properties on error objects are camelCase instead of snake_case

Added

• Streams - Added base classes for Readable, Writable, Duplex, and Transform
• Streaming interfaces for Crypto API
• process: add getgroups(), setgroups(), initgroups()
• crypto: getHashes() getCiphers()
• http: add response.headersSent property
• events: 'removeListener' event
• setImmediate() and clearImmediate() functions