This article covers features introduced in SpiderMonkey 17
Test whether the given string is a valid ECMAScript identifier.
Syntax
bool JS_IsIdentifier(JSContext *cx, JS::HandleString str, bool *isIdentifier); bool JS_IsIdentifier(const char16_t *chars, size_t length); // Added in SpiderMonkey 38
Name | Type | Description |
---|---|---|
cx |
JSContext * |
Pointer to a JS context from which to derive runtime information. Requires request. In a JS_THREADSAFE build, the caller must be in a request on this JSContext . |
str |
JS::HandleString |
The string to test. |
chars |
const char16_t * |
The pointer of the string to test. |
length |
size_t |
The length of chars . |
isIdentifier |
bool * |
Out parameter. On success, *isIdentifier receives whether str is an identifier or not. |
Description
JS_IsIdentifier
tests if the given string is a valid ECMAScript identifier. On successful, JS_IsIdentifier
stores the test result to *isIdentifier
and returns true
, otherwise returns false
and the value of *isIdentifier
is undefined.
JS_IsIdentifier
which takes chars
and length
is infallible, so just returns whether the chars are an identifier.