【Node.js24.x】Object::convertALPNProtocols()メソッドの使い方

convertALPNProtocolsメソッドは、ALPN (Application-Layer Protocol Negotiation) プロトコル識別子のリストを特定の形式に変換する処理を実行するメソッドです。このメソッドは、Node.jsにおけるセキュアなネットワーク通信、特にTLS/SSLを利用した接続において、クライアントとサーバー間でアプリケーション層プロトコルを効率的に合意するためのALPNメカニズムを支援するために利用されます。

具体的には、"http/2"や"http/1.1"といったアプリケーション層プロトコル名を文字列の配列として受け取ります。そして、これらをTLS/SSLライブラリが内部で処理できるバイナリ形式や、特定のデータ構造へと変換します。この変換は、TLSハンドシェイクの過程でクライアントとサーバーがサポートするALPNプロトコルの一覧を交換し、最適なプロトコルを決定するために不可欠なステップとなります。

通常、このメソッドはNode.jsのTLSモジュール内部で利用されることが多く、開発者が直接呼び出す機会は少ないかもしれません。しかし、基盤となる通信プロトコルのネゴシエーションにおいて重要な役割を担っており、ALPNの柔軟な設定や、多様なアプリケーション層プロトコルへの対応を可能にしています。この機能により、Node.jsアプリケーションは、最新のWebプロトコルやカスタムプロトコルを用いたセキュアな通信を安定して確立できます。このメソッドは、Node.js 24モジュールの一部として提供され、Objectクラスに属しています。

Copy
1const tls = require('tls');
2const alpnProtocols = ['h2', 'http/1.1'];
3const convertedProtocolsBuffer = tls.convertALPNProtocols(alpnProtocols);

引数なし

引数はありません

Buffer | null

convertALPNProtocolsメソッドは、ALPN（Application-Layer Protocol Negotiation）プロトコルをNode.jsが内部で扱うためのBuffer形式に変換した結果、または変換できなかった場合はnullを返します。