Nightingale Posing Mischievously
    Wondering what’s next for npm?Check out our public roadmap! »

    guid-ts
    TypeScript icon, indicating that this package has built-in type declarations

    1.1.1 • Public • Published

    guid-ts

    Build and Test Typescript CI Quality Gate Status npm bundle size

    Package for generating and managing globally unique identifiers (GUIDs) v4 in Typescript.

    Lightweight, simple, dependency free, and reliable package.

    This package provides a class which can parse and generate a GUID based on the RFC4122. The package also expose methods to manage GUIDs.

    The focus of this package is to provide a simple mechanism to generate and manage v4 UUIDs, following this principles:

    • Keep It Simple Stupid (KISS Principle)
    • Keep it lightweight
    • Dependency free
    • Well tested
    • Reliable
    • RFC compilant (RFC4122)
    • Compatible with all major browsers
    • Up-to-date

    Installation

    Simply install it with your favourite package manager:

    Yarn

    yarn add guid-ts

    NPM

    npm install guid-ts

    Usage

    import { Guid } from 'guid-ts';
    
    const newGuid = Guid.newGuid(); // => ex: b631e90e-6e7f-488e-88fb-a7c2ef44bb8d

    You can use and test the package online on Stackblitz, checkout our example playground: guid-ts-playground.

    Documentation

    You can find all the code documentation in https://piraces.github.io/guid-ts/index.html. The documentation is generated using TypeDoc, and resides in the docs folder.

    How does it works?

    The implementation is very simple. It basically generates random numbers to compose a valid v4 UUID, following the specification and a regex to check it.

    How do it generates random numbers?

    In order to support all browsers as possible, the implementation checks if the browser has implemented the Crypto API (or mscrypto in the case of IE11), in order to generate the random values, since it is a more reliable source for random values. If the crypto object its not available in runtime, then Math.random() is used as a fallback (which is a less reliable source of random values, but available in almost all browsers).

    Browsers support

    IE / Edge
    IE / Edge
    Firefox
    Firefox
    Chrome
    Chrome
    Safari
    Safari
    iOS Safari
    iOS Safari
    Samsung
    Samsung
    Opera
    Opera
    IE6-IE11, Edge 2-latest 4-latest 3.1-latest 3.2-latest 4-latest 10-latest

    Install

    npm i guid-ts

    DownloadsWeekly Downloads

    34

    Version

    1.1.1

    License

    MIT

    Unpacked Size

    18.6 kB

    Total Files

    5

    Last publish

    Collaborators

    • avatar