{"_id":"uuid-browser","_rev":"461529","name":"uuid-browser","description":"browser-part from the uuid-package","dist-tags":{"latest":"3.1.0"},"maintainers":[{"name":"heikomat","email":"heiko.mathes@gmail.com"}],"time":{"modified":"2024-08-27T19:27:52.000Z","created":"2017-10-24T06:24:34.134Z","3.1.0":"2017-10-24T07:24:23.268Z","0.1.0":"2017-10-24T06:24:34.134Z"},"users":{},"author":{"name":"Heiko Mathes","email":"heiko.mathes@gmail.com"},"repository":{"type":"git","url":"git+https://github.com/heikomat/uuid-browser.git"},"versions":{"3.1.0":{"name":"uuid-browser","version":"3.1.0","description":"browser-part from the uuid-package","main":"index.js","author":{"name":"Heiko Mathes","email":"heiko.mathes@gmail.com"},"license":"MIT","bugs":{"url":"https://github.com/heikomat/uuid-browser/issues"},"repository":{"type":"git","url":"git+https://github.com/heikomat/uuid-browser.git"},"gitHead":"e5be7b01be7a9ff7721fcedd2c36219a2abd0bf9","homepage":"https://github.com/heikomat/uuid-browser#readme","_id":"uuid-browser@3.1.0","scripts":{},"_shasum":"0f05a40aef74f9e5951e20efbf44b11871e56410","_from":".","_npmVersion":"4.2.0","_nodeVersion":"7.10.0","_npmUser":{"name":"heikomat","email":"heiko.mathes@gmail.com"},"dist":{"shasum":"0f05a40aef74f9e5951e20efbf44b11871e56410","size":6776,"noattachment":false,"key":"/uuid-browser/-/uuid-browser-3.1.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/uuid-browser/download/uuid-browser-3.1.0.tgz"},"maintainers":[{"name":"heikomat","email":"heiko.mathes@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/uuid-browser-3.1.0.tgz_1508829862214_0.8543582698330283"},"directories":{},"publish_time":1508829863268,"_cnpm_publish_time":1508829863268,"_hasShrinkwrap":false,"deprecated":"Package no longer supported and required. Use the uuid package or crypto.randomUUID instead"},"0.1.0":{"name":"uuid-browser","version":"0.1.0","description":"browser-part from the uuid-package","main":"index.js","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"author":{"name":"Heiko Mathes","email":"heiko.mathes@gmail.com"},"license":"ISC","_id":"uuid-browser@0.1.0","_shasum":"fa4fe707f4721c44cf2cb55a70d412f7f8adbec9","_from":".","_npmVersion":"4.2.0","_nodeVersion":"7.10.0","_npmUser":{"name":"heikomat","email":"heiko.mathes@gmail.com"},"dist":{"shasum":"fa4fe707f4721c44cf2cb55a70d412f7f8adbec9","size":298,"noattachment":false,"key":"/uuid-browser/-/uuid-browser-0.1.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/uuid-browser/download/uuid-browser-0.1.0.tgz"},"maintainers":[{"name":"heikomat","email":"heiko.mathes@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/uuid-browser-0.1.0.tgz_1508826273225_0.24998627579770982"},"directories":{},"publish_time":1508826274134,"_hasShrinkwrap":false,"_cnpm_publish_time":1508826274134,"deprecated":"Package no longer supported and required. Use the uuid package or crypto.randomUUID instead"}},"readme":"# ALL THE CODE IN THIS PACKAGE COMES FROM THE [UUID-PACKAGE](https://www.npmjs.com/package/uuid)\nLike seriously, nothing in this package is made by me\n\n# uuid-browser\n\nSimple, fast generation of [RFC4122](http://www.ietf.org/rfc/rfc4122.txt) UUIDS.\n\nFeatures:\n\n* Support for version 1, 4 and 5 UUIDs\n* Cross-platform\n* Uses cryptographically-strong random number APIs (when available)\n* Zero-dependency, small footprint (... but not [this small](https://gist.github.com/982883))\n\n## Quickstart - CommonJS (Recommended)\n\n```shell\nnpm install uuid\n```\n\nThen generate your uuid version of choice ...\n\nVersion 1 (timestamp):\n\n```javascript\nconst uuidv1 = require('uuid/v1');\nuuidv1(); // -> '6c84fb90-12c4-11e1-840d-7b25c5ee775a'\n```\n\nVersion 4 (random):\n\n```javascript\nconst uuidv4 = require('uuid/v4');\nuuidv4(); // -> '110ec58a-a0f2-4ac4-8393-c866d813b8d1'\n```\n\nVersion 5 (namespace):\n\n```javascript\nconst uuidv5 = require('uuid/v5');\n\n// ... using predefined DNS namespace (for domain names)\nuuidv5('hello.example.com', uuidv5.DNS)); // -> 'fdda765f-fc57-5604-a269-52a7df8164ec'\n\n// ... using predefined URL namespace (for, well, URLs)\nuuidv5('http://example.com/hello', uuidv5.URL); // -> '3bbcee75-cecc-5b56-8031-b6641c1ed1f1'\n\n// ... using a custom namespace\nconst MY_NAMESPACE = '<UUID string you previously generated elsewhere>';\nuuidv5('Hello, World!', MY_NAMESPACE); // -> '90123e1c-7512-523e-bb28-76fab9f2f73d'\n```\n\n## Quickstart - Browser-ready Versions\n\nBrowser-ready versions of this module are available via [wzrd.in](https://github.com/jfhbrook/wzrd.in).\n\nFor version 1 uuids:\n\n```html\n<script src=\"http://wzrd.in/standalone/uuid%2Fv1@latest\"></script>\n<script>\nuuidv1(); // -> v1 UUID\n</script>\n```\n\nFor version 4 uuids:\n\n```html\n<script src=\"http://wzrd.in/standalone/uuid%2Fv4@latest\"></script>\n<script>\nuuidv4(); // -> v4 UUID\n</script>\n```\n\nFor version 5 uuids:\n\n```html\n<script src=\"http://wzrd.in/standalone/uuid%2Fv5@latest\"></script>\n<script>\nuuidv5('http://example.com/hello', uuidv5.URL); // -> v5 UUID\n</script>\n```\n\n## API\n\n### Version 1\n\n```javascript\nconst uuidv1 = require('uuid/v1');\n\n// Allowed arguments\nuuidv1();\nuuidv1(options);\nuuidv1(options, buffer, offset);\n```\n\nGenerate and return a RFC4122 v1 (timestamp-based) UUID.\n\n* `options` - (Object) Optional uuid state to apply. Properties may include:\n\n  * `node` - (Array) Node id as Array of 6 bytes (per 4.1.6). Default: Randomly generated ID.  See note 1.\n  * `clockseq` - (Number between 0 - 0x3fff) RFC clock sequence.  Default: An internally maintained clockseq is used.\n  * `msecs` - (Number | Date) Time in milliseconds since unix Epoch.  Default: The current time is used.\n  * `nsecs` - (Number between 0-9999) additional time, in 100-nanosecond units. Ignored if `msecs` is unspecified. Default: internal uuid counter is used, as per 4.2.1.2.\n\n* `buffer` - (Array | Buffer) Array or buffer where UUID bytes are to be written.\n* `offset` - (Number) Starting index in `buffer` at which to begin writing.\n\nReturns `buffer`, if specified, otherwise the string form of the UUID\n\nNote: The <node> id is generated guaranteed to stay constant for the lifetime of the current JS runtime. (Future versions of this module may use persistent storage mechanisms to extend this guarantee.)\n\nExample: Generate string UUID with fully-specified options\n\n```javascript\nuuidv1({\n  node: [0x01, 0x23, 0x45, 0x67, 0x89, 0xab],\n  clockseq: 0x1234,\n  msecs: new Date('2011-11-01').getTime(),\n  nsecs: 5678\n});   // -> \"710b962e-041c-11e1-9234-0123456789ab\"\n```\n\nExample: In-place generation of two binary IDs\n\n```javascript\n// Generate two ids in an array\nconst arr = new Array(32); // -> []\nuuidv1(null, arr, 0);   // -> [02 a2 ce 90 14 32 11 e1 85 58 0b 48 8e 4f c1 15]\nuuidv1(null, arr, 16);  // -> [02 a2 ce 90 14 32 11 e1 85 58 0b 48 8e 4f c1 15 02 a3 1c b0 14 32 11 e1 85 58 0b 48 8e 4f c1 15]\n```\n\n### Version 4\n\n```javascript\nconst uuidv4 = require('uuid/v4')\n\n// Allowed arguments\nuuidv4();\nuuidv4(options);\nuuidv4(options, buffer, offset);\n```\n\nGenerate and return a RFC4122 v4 UUID.\n\n* `options` - (Object) Optional uuid state to apply. Properties may include:\n  * `random` - (Number[16]) Array of 16 numbers (0-255) to use in place of randomly generated values\n  * `rng` - (Function) Random # generator function that returns an Array[16] of byte values (0-255)\n* `buffer` - (Array | Buffer) Array or buffer where UUID bytes are to be written.\n* `offset` - (Number) Starting index in `buffer` at which to begin writing.\n\nReturns `buffer`, if specified, otherwise the string form of the UUID\n\nExample: Generate string UUID with fully-specified options\n\n```javascript\nuuid.v4({\n  random: [\n    0x10, 0x91, 0x56, 0xbe, 0xc4, 0xfb, 0xc1, 0xea,\n    0x71, 0xb4, 0xef, 0xe1, 0x67, 0x1c, 0x58, 0x36\n  ]\n});\n// -> \"109156be-c4fb-41ea-b1b4-efe1671c5836\"\n```\n\nExample: Generate two IDs in a single buffer\n\n```javascript\nconst buffer = new Array(32); // (or 'new Buffer' in node.js)\nuuid.v4(null, buffer, 0);\nuuid.v4(null, buffer, 16);\n```\n\n### Version 5\n\n```javascript\nconst uuidv5 = require('uuid/v4');\n\n// Allowed arguments\nuuidv5(name, namespace);\nuuidv5(name, namespace, buffer);\nuuidv5(name, namespace, buffer, offset);\n```\n\nGenerate and return a RFC4122 v4 UUID.\n\n* `name` - (String | Array[]) \"name\" to create UUID with\n* `namespace` - (String | Array[]) \"namespace\" UUID either as a String or Array[16] of byte values\n* `buffer` - (Array | Buffer) Array or buffer where UUID bytes are to be written.\n* `offset` - (Number) Starting index in `buffer` at which to begin writing. Default = 0\n\nReturns `buffer`, if specified, otherwise the string form of the UUID\n\nExample:\n\n```javascript\n// Generate a unique  namespace (typically you would do this once, outside of\n// your project, then bake this value into your code)\nconst uuidv4 = require('uuid/v4');\nconst MY_NAMESPACE = uuidv4();  //\n\n// Generate a couple namespace uuids\nconst uuidv5 = require('uuid/v5');\nuuidv5('hello', MY_NAMESPACE);\nuuidv5('world', MY_NAMESPACE);\n```\n\n## Testing\n\n```shell\nnpm test\n```\n\n## Deprecated / Browser-ready API\n\nThe API below is available for legacy purposes and is not expected to be available post-3.X\n\n```javascript\nconst uuid = require('uuid');\n\nuuid.v1(...); // alias of uuid/v1\nuuid.v4(...); // alias of uuid/v4\nuuid(...);    // alias of uuid/v4\n\n// uuid.v5() is not supported in this API\n```\n\n## Legacy node-uuid package\n\nThe code for the legacy node-uuid package is available in the `node-uuid` branch.\n","_attachments":{},"homepage":"https://github.com/heikomat/uuid-browser#readme","bugs":{"url":"https://github.com/heikomat/uuid-browser/issues"},"license":"MIT"}