a few new functions

Author: rozek

README.md

@@ -160,6 +160,7 @@ The following functions check whether a given argument satisfies a certain const
 * **`ValueIsJSONString (Value:unknown):boolean`**<br>returns `true` if the given `Value` is a string which can be parsed with `JSON.parse` - or `false` otherwise
 * **`ValueIsBase64 (Value:unknown):boolean`**<br>returns `true` if the given `Value` is a non-empty, correctly padded Base64-encoded string (using the standard alphabet) - or an empty string - and `false` otherwise
 * **`ValueIsHexString (Value:unknown):boolean`**<br>returns `true` if the given `Value` is a non-empty string consisting of hexadecimal digits only - or `false` otherwise
+* **`ValueIsIdentifier (Value:unknown):boolean`**<br>returns `true` if the given `Value` is a string containing a syntactically valid JavaScript identifier (checked against the full Unicode grammar, i.e., `ID_Start` followed by `ID_Continue` characters, incl. `$`, `_`, ZWNJ and ZWJ - reserved words are *not* rejected) - or `false` otherwise
 
 ### Argument Validation Functions ###
 
@@ -213,7 +214,7 @@ For the sake of clarity, however, only the first "flavour" (namely `allowXXX`) i
 * **`allowPhoneNumber (Description:string, Argument:any):string|null|undefined`**<br>checks if the given `Argument` (if it exists) is a string containing a syntactically plausible phone number in a common national or international notation (see `ValueIsPhoneNumber`). If this is the case (or `Argument` is missing), the function returns the primitive value of the given `Argument`, otherwise an error is thrown whose message contains the given `Description`
 * **`allowE164PhoneNumber (Description:string, Argument:any):string|null|undefined`**<br>checks if the given `Argument` (if it exists) is a string containing a phone number in the canonical E.164 format (see `ValueIsE164PhoneNumber`). If this is the case (or `Argument` is missing), the function returns the primitive value of the given `Argument`, otherwise an error is thrown whose message contains the given `Description`<br>&nbsp;<br>
 * **`allowBigInt`**, **`allowSymbol`**, **`allowMap`**, **`allowSet`**, **`allowTypedArray`**, **`allowArrayBuffer`**<br>validate the given `Argument` using `ValueIsBigInt`, `ValueIsSymbol`, `ValueIsMap`, `ValueIsSet`, `ValueIsTypedArray` or `ValueIsArrayBuffer`, resp., and behave like any other `allowXXX` function described above (incl. their `allowedXXX`, `expectXXX` and `expectedXXX` flavours)
-* **`allowUUID`**, **`allowISODate`**, **`allowISOTimestamp`**, **`allowIPv4Address`**, **`allowIPv6Address`**, **`allowHostName`**, **`allowPortNumber`**, **`allowJSONString`**, **`allowBase64`**, **`allowHexString`**<br>validate the given `Argument` using the corresponding `ValueIsXXX` classifier and behave like any other `allowXXX` function described above (incl. their `allowedXXX`, `expectXXX` and `expectedXXX` flavours)
+* **`allowUUID`**, **`allowISODate`**, **`allowISOTimestamp`**, **`allowIPv4Address`**, **`allowIPv6Address`**, **`allowHostName`**, **`allowPortNumber`**, **`allowJSONString`**, **`allowBase64`**, **`allowHexString`**, **`allowIdentifier`**<br>validate the given `Argument` using the corresponding `ValueIsXXX` classifier and behave like any other `allowXXX` function described above (incl. their `allowedXXX`, `expectXXX` and `expectedXXX` flavours)
 
 ### Utility Functions ###
 

dist/javascript-interface-library.d.ts

@@ -53,6 +53,8 @@ export declare const allowedHexString: (Description: string, Argument: any) => s
 
 export declare const allowedHostName: (Description: string, Argument: any) => string | null | undefined;
 
+export declare const allowedIdentifier: (Description: string, Argument: any) => string | null | undefined;
+
 export declare const allowedInstanceOf: typeof allowInstanceOf;
 
 export declare const allowedInteger: (Description: string, Argument: any) => number | null | undefined;
@@ -139,6 +141,8 @@ export declare const allowHexString: (Description: string, Argument: any) => str
 
 export declare const allowHostName: (Description: string, Argument: any) => string | null | undefined;
 
+export declare const allowIdentifier: (Description: string, Argument: any) => string | null | undefined;
+
 /**** allow[ed]InstanceOf ****/
 export declare function allowInstanceOf(Description: string, Argument: any, constructor: Function, Expectation: string): any | null | undefined;
 
@@ -430,6 +434,8 @@ export declare const expectedHexString: (Description: string, Argument: any) =>
 
 export declare const expectedHostName: (Description: string, Argument: any) => string;
 
+export declare const expectedIdentifier: (Description: string, Argument: any) => string;
+
 export declare const expectedInstanceOf: typeof expectInstanceOf;
 
 export declare const expectedInteger: (Description: string, Argument: any) => number;
@@ -518,6 +524,8 @@ export declare const expectHexString: (Description: string, Argument: any) => st
 
 export declare const expectHostName: (Description: string, Argument: any) => string;
 
+export declare const expectIdentifier: (Description: string, Argument: any) => string;
+
 /**** expect[ed]InstanceOf ****/
 export declare function expectInstanceOf(Description: string, Argument: any, constructor: Function, Expectation: string): any;
 
@@ -731,6 +739,8 @@ export declare function ValueIsHexString(Value: unknown): Value is string;
 
 export declare function ValueIsHostName(Value: unknown): Value is string;
 
+export declare function ValueIsIdentifier(Value: unknown): Value is string;
+
 /**** ValueIsInstanceOf ****/
 export declare function ValueIsInstanceOf<T>(Value: unknown, Constructor: abstract new (...ArgumentList: any[]) => T): Value is T;