Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

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

randomUUIDメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

randomUUIDメソッドは、グローバルに一意な識別子であるUUID(Universally Unique Identifier)を生成するメソッドです。このメソッドは、分散システムやデータベース、Webアプリケーションなど、様々な環境で固有のIDが必要となる場面で利用されます。例えば、新しく作成するレコードの主キー、セッションの識別子、一時ファイルの命名など、データの一意性を保証したい場合に非常に有用です。

生成されるUUIDは、RFC 4122で定義されたバージョン4の形式に従います。これはランダムな数値を基にしており、極めて低い確率で重複のないIDを提供します。その典型的な表現は、ハイフンで区切られた32桁の16進数文字列(例: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx)です。高い信頼性で一意なIDを手軽に生成できるため、システム開発におけるID管理の複雑さを軽減し、データの一貫性と整合性を保つのに役立ちます。Node.js環境で、安全かつ効率的にUUIDを生成する標準的な方法として提供されています。

構文(syntax)

import { randomUUID } from 'node:crypto';

const uuid = randomUUID();

引数(parameters)

options = {}

  • options: object = {}: UUID生成に関するオプションを指定します。
    • random: Buffer: UUID生成に使用するランダムなバイト列を指定します。
    • rng: Function: 乱数生成器関数を指定します。

戻り値(return)

string

ランダムに生成されたUUID(Universally Unique Identifier)文字列を返します。この文字列は、アプリケーション内で一意な識別子として利用できます。

関連コンテンツ

関連プログラミング言語