Easy GUID type implementation for Typescript
npm install ez-guidThe library ez-guid serves as type definition for globally unique IDs(GUIDs) in Typescript and therefore provides interfaces to generate/parse/compare/validate them.
b77d409a-10cd-4a47-8e94-b0cd0ab50aa1
`Non-hyphenated (32 chars):
`
b77d409a10cd4a478e94b0cd0ab50aa1
`
All GUIDs are transformed and stored internally as defined in the RFC 4122 specificationGetting started
$3
`
npm i ez-guid
`
For NPM version < 5
`
npm install ez-guid --save
`$3
#### Random GUID
`typescript
import { Guid } from "ez-guid";export class Example {
public id: Guid;
constructor() {
//using the static method
this.id = Guid.create(); // ==> random GUID, e.g. b77d409a-10cd-4a47-8e94-b0cd0ab50aa1
//using the provided constructor
this.id = new Guid(); //random aswell
}
}
`#### GUID from a string
`typescript
import { Guid } from "ez-guid";export class Example {
public id: Guid;
constructor() {
//using the static method
this.id = Guid.create("b77d409a-10cd-4a47-8e94-b0cd0ab50aa1");
//using the provided constructor
this.id = new Guid("b77d409a-10cd-4a47-8e94-b0cd0ab50aa1");
//no hyphens
this.id = new Guid("b77d409a10cd4a478e94b0cd0ab50aa1"); //transformed to b77d409a-10cd-4a47-8e94-b0cd0ab50aa1
}
}
``| Method/Prop | Description|
|---|---|
| static isValid (guid: any): boolean | Check if value is a guid code |
| static create (guid?: string): Guid | Creates a new Guid instance; random if no param given |
| static createEmpty (): Guid | Creates an empty GUID |
| static random(): string | Creates and returns a random GUID string |
| equals (other: Guid): boolean | Compares two Guid instances with each other |
| isEmpty (): boolean | Validates if a GUID instance is empty (GUID containing only zeros) |
| toString (): string | Returns a guid as string |
| toShortString(): string | Returns a guid as string without hyphens |