uuidv5

Generates named version 5 UUIDs

Usage no npm install needed!

<script type="module">
  import uuidv5 from 'https://cdn.skypack.dev/uuidv5';
</script>

README

UUIDv5

Install

npm install uuidv5

Use

var uuidv5 = require('uuidv5');

If you are unfamiliar with v5 UUIDs, read this. For a deeper look, read RFC 4122.

API

uuidv5(namespace, name, [raw_output])

  • namespace can be 'url', 'dns', 'oid', 'x500', or 'null'. If it's none of those, it must be a UUID to use as a namespace, either in string or Buffer form.
  • name can be a string or Buffer. What it should contain is namespace-dependent.
  • raw_output is an optional flag. If set to true, the UUID will be returned as a Buffer instead of as a string.

uuidv5.uuidToString(uuid)

Takes a Buffer-form uuid and returns it as a string.

uuidv5.uuidFromString(uuidStr)

Takes a UUID as a string (with or without dashes [-]) and returns it as a Buffer.

Examples

var uuidv5 = require('uuidv5');

// Generate a UUID in the default URL namespace
var urlUUID = uuidv5('url', 'http://google.com/page');

// Default DNS namespace
var dnsUUID = uuidv5('dns', 'google.com');

// Create your own namespace
var privns = uuidv5('null', 'my-private-namespace', true); // Buffer form is more efficient
var privUUID = uuidv5(privns, 'some-named-thing');