Skip to content

Api changes between v0.8 and v0.10

Jump to bottom Edit New page
koichik edited this page Mar 12, 2013 · 3 revisions

このページを編集する場合は、できるだけ詳しく記述してください。サンプル歓迎！

Changed

  • Streams インタフェース

    • Readable, Writable, Duplex, そして Transform ベースクラスが追加されました。
    • Readable ストリームは、すぐに 'data' イベントを発する代わりに、read() メソッドを使用します。
    • 'data' イベントハンドラを追加するか、pause() または resume() を呼び出すと、"旧モード" に切り替わります。
      • これは、data イベントハンドラはそれが追加されるより前の最初のチャンクを失わないことと、pause() はもはや単なるアドバイスではないことを意味します。
    • もしデータを消費しなければ、ストリームはずっと中断状態となります。そして 'end' イベントは決して発生しません。

  • uv_after_work_cb のシグネチャが変更され、状態を示すために2番目の整数型の引数を受け取るようになりました。後方互換性のため、第4引数は明示的に uv_queue_work にキャストします。例

  • process.nextTick は現在の tick が終わった後、現在のスタックが巻き戻された直後に発生します。もし再帰処理のために nextTick を使っているなら、代わりに setImmediate を使ってください。

  • -p --print コマンドライン引数は -e --eval を意味します。 +* net: net.createServer() によって作成されるソケットはもはや 'connect' イベントを生成しません。'connection' イベントのリスナが呼ばれた時、ソケットはすでに接続済みです。そのため、これは余計です。

  • url: 解析されたオブジェクトは常に全てのプロパティを含み、使われていないものには null が設定されます。例:

    // 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: エラーオブジェクトに加えられるプロパティは、スネークケースではなくキャメルケースになりました。

  • path.resolve および path.join は文字列以外の入力に対して TypeError をスローします。

  • dgram.Socket#bind() は常に非同期になりました。もし次のようなコードがあると:

    var s = dgram.createSocket('udp4');
s.bind(1234);
s.addMembership('224.0.0.114');

    これは次のように変更されなければなりません。

    var s = dgram.createSocket('udp4');
s.bind(1234, function() {
  s.addMembership('224.0.0.114');
});

  • EventEmitter のコンストラクタは様々なプロパティを設定するようになりました。それは今でも OOP 継承の親として動作しますが、正しく継承しなければなりません。「壊れたスタイル」の継承パターンで拡張された EventEmitter の拡張クラスは動作しないでしょう。そのスタイルの継承はこれまでもサポートされていませんでしたが、0.10 以前は実際には問題になりませんでした。

    // 壊れたスタイルの継承、これは安全でもなければよくもありませんでしたが、
// Webでは多くの壊れたチュートリアルで見られます。
function Child() {}
Child.prototype = new Parent(); // <-- 決してやってはいけません！！
// もしこれをどこかの JavaScript ライブラリで見かけたら、
// これは大きくて酷い間違いだ！ と教えてください。
// クラスの継承は、全ての子クラスのインスタンスから共有されるプロトタイプ上で
// そのクラスのコンストラクタを呼び出してはいけません！

// 正しいスタイルの継承
function Child() {
  Parent.call(this);
}
Child.prototype = Object.create(Parent.prototype, {
  constructor: {
    value: Child,
    enumerable: false,
    writable: true,
    configurable: true
  }
});
// 「なんてたくさんの行！ ヘルパーメソッドはないの！」
// あります。こうしてください:
util.inherits(Child, Parent);

  • https はデフォルトで相手の証明書を検証するようになりました。 これは、デフォルト CA リストにない認証局を使って SSL エンドポイントにアクセスを試みた場合、以前にはなかったエラーを受け取ることを意味します。 rejectUnauthorized を false に設定することにより、以前の振る舞いになります。

  • ネイティブ アドオン は、完全な module オブジェクトを受け取れるようになり、カスタムのオブジェクトまたは関数 (すなわち "substack パターン) で exports を上書きすることが可能になりました。 単に Init() 関数に第2引数を加えることで、module オブジェクトが与えられます: void Init(Handle<Object> exports, Handle<Object> module); アドオンの例 は昔からの方法と、exports を上書きする方法の両方を混在させています (追加のサンプルは GitHub repo から利用可能です)。

    旧来の方法

    Handle<Value> Booya(const Arguments& args) {
  HandleScope scope;
  return scope.Close(String::New("hello world"));
}
void Init(Handle<Object> exports) {
  exports->Set(String::NewSymbol("booya"), FunctionTemplate::New(Booya)->GetFunction());
}
NODE_MODULE(addon, Init)
    console.log(require('./build/Release/addon').booya())

    一つの関数をexports

    Handle<Value> Booya(const Arguments& args) {
  HandleScope scope;
  return scope.Close(String::New("hello world"));
}
void Init(Handle<Object> exports, Handle<Object> module) {
  module->Set(String::NewSymbol("exports"), FunctionTemplate::New(Booya)->GetFunction());
}
NODE_MODULE(addon, Init)
    console.log(require('./build/Release/addon')())

Added

  • Streams - Readable, Writable, Duplex, そして Transform ベースクラス
  • Crypto API のストリーミングインタフェース
  • process: getgroups(), setgroups(), initgroups()
  • crypto: getHashes(), getCiphers()
  • http: response.headerSent プロパティ
  • events: 'removeListener' イベント
  • setImmediate() および clearImmediate() 関数
  • string_decoder: decoder.end() 関数と BASE-64 エンコーディング
Add a custom footer
Add a custom sidebar
Clone this wiki locally