Advanced macros

Document updated on Dec 12, 2022

The advanced macros are powerful functions that allow you to declare Security Policies with simple expressions, reducing code complexity and speeding up development. Advanced macros are not available on the CEL component, only on Security Policies.

You have the following list of advanced macros always available unless you set in the configuration the disable_advanced_macros flag to true.

Math

between

Checks if a specific value is between two numbers of the same numeric type, including the limiting numbers. E.g.: between(2,5,7) returns true because 2 is between the range.

<double>.between(<double>, <double>) -> <bool>
<int>.between(<int>, <int>) -> <bool>
between(<int>, <int>, <int>) -> <bool>
between(<double>, <double>, <double>) -> <bool>

Examples

between(2,2,2) // returns true
between(2,5,7) // returns false
2.between(1,3) // returns true
2.between(4,5) // returns false
2.0.between(1.9,2.1) // returns true

Strings

isEmpty

Returns true when a specific value does not exist, or it has an empty value (e.g., a string is "")

isEmpty(<dyn>) -> <bool>

Examples

isEmpty(object.a) // returns true when object is {"a":"", "b":2}
isEmpty(object.a) // returns true when object is {"a":null, "b":2}
isEmpty(object.c) // returns true when object is {"a":1, "b":2}
isEmpty(object.a) // returns false when object is {"a":"hi", "b":2}

isAlphanumeric

Checks if a specific value is an alphanumeric string. English letters and numbers only. No other characters are allowed.

isAlphanumeric(<string>) -> <bool>
<string>.isAlphanumeric() -> <bool>

Examples

isAlphanumeric("") // returns true
isAlphanumeric("abcDFG123") // returns true
isAlphanumeric("abcD-G123") // returns false
"abcDFG123".isAlphanumeric() // returns true
"abcD-G123".isAlphanumeric() // returns false

isAlphabetic

Checks if a specific value is an alphabetic string. English letters only. No other characters are allowed.

isAlphabetic(<string>) -> <bool>
<string>.isAlphabetic() -> <bool>

Examples

isAlphabetic("") // returns true
isAlphabetic("abcDFG") // returns true
isAlphabetic("abcD-G") // returns false
"abcDFG".isAlphabetic() // returns true
"abcD-G".isAlphabetic() // returns false

find

Returns the first match for the provided regular expression.

<string>.find(<string>) -> <string>

Examples

"abc 123".find('[0-9]*') // returns '123'
"abc 123".find('xyz') // returns ''

charAt

Returns the character at the given position. If the position is negative or greater than the length of the string, the function will produce an error

<string>.charAt(<int>) -> <string>

Examples

'hello'.charAt(4)  // returns 'o'
'hello'.charAt(5)  // returns ''
'hello'.charAt(-1) // error

indexOf

Returns the integer index of the first occurrence of the search string. If the search string is not found, the function returns -1.

The function also accepts an optional position from which to begin the substring search. If the substring is the empty string, the index where the search starts is returned (zero or custom).

<string>.indexOf(<string>) -> <int>
<string>.indexOf(<string>, <int>) -> <int>

Examples

'hello mellow'.indexOf('')         // returns 0
'hello mellow'.indexOf('ello')     // returns 1
'hello mellow'.indexOf('jello')    // returns -1
'hello mellow'.indexOf('', 2)      // returns 2
'hello mellow'.indexOf('ello', 2)  // returns 7
'hello mellow'.indexOf('ello', 20) // error

join

Returns a new string where the elements of string list are concatenated. The function also accepts an optional separator which is placed between elements in the resulting string.

<list<string>>.join() -> <string>
<list<string>>.join(<string>) -> <string>

Examples

['hello', 'mellow'].join() // returns 'hellomellow'
['hello', 'mellow'].join(' ') // returns 'hello mellow'
[].join() // returns ''
[].join('/') // returns ''

lastIndexOf

Returns the integer index at the start of the last occurrence of the search string. If the the search string is not found, the function returns -1. The function also accepts an optional position which represents the last index to be considered as the beginning of the substring match. If the substring is the empty string, the index where the search starts is returned (string length or custom).

<string>.lastIndexOf(<string>) -> <int>
<string>.lastIndexOf(<string>, <int>) -> <int>

Examples

'hello mellow'.lastIndexOf('')         // returns 12
'hello mellow'.lastIndexOf('ello')     // returns 7
'hello mellow'.lastIndexOf('jello')    // returns -1
'hello mellow'.lastIndexOf('ello', 6)  // returns 1
'hello mellow'.lastIndexOf('ello', -1) // error

lowerAscii

Returns a new string where all ASCII characters are lower-cased. This function does not perform Unicode case-mapping for characters outside the ASCII range.

<string>.lowerAscii() -> <string>

Examples

'TacoCat'.lowerAscii()      // returns 'tacocat'
'TacoCÆt Xii'.lowerAscii()  // returns 'tacocÆt xii'

replace

Returns a new string based on the target, which replaces the occurrences of a search string with a replacement string if present. The function accepts an optional limit on the number of substring replacements to be made.

When the replacement limit is 0, the result is the original string. When the limit is a negative number, the function behaves the same as replace all.

<string>.replace(<string>, <string>) -> <string>
<string>.replace(<string>, <string>, <int>) -> <string>

Examples

'hello hello'.replace('he', 'we')     // returns 'wello wello'
'hello hello'.replace('he', 'we', -1) // returns 'wello wello'
'hello hello'.replace('he', 'we', 1)  // returns 'wello hello'
'hello hello'.replace('he', 'we', 0)  // returns 'hello hello'

split

Returns a list of strings split from the input by the given separator. The function accepts an optional argument specifying a limit on the number of substrings produced by the split.

When the split limit is 0, the result is an empty list. When the limit is 1, the result is the target string to split. When the limit is a negative number, the function behaves the same as split all.

<string>.split(<string>) -> <list<string>>
<string>.split(<string>, <int>) -> <list<string>>

Examples

'hello hello hello'.split(' ')     // returns ['hello', 'hello', 'hello']
'hello hello hello'.split(' ', 0)  // returns []
'hello hello hello'.split(' ', 1)  // returns ['hello hello hello']
'hello hello hello'.split(' ', 2)  // returns ['hello', 'hello hello']
'hello hello hello'.split(' ', -1) // returns ['hello', 'hello', 'hello']

substring

Returns the substring given a numeric range corresponding to character positions. Optionally may omit the trailing range for a substring from a given character position until the end of a string.

Character offsets are 0-based with an inclusive start range and exclusive end range. It is an error to specify an end range that is lower than the start range, or for either the start or end index to be negative or exceed the string length.

<string>.substring(<int>) -> <string>
<string>.substring(<int>, <int>) -> <string>

Examples

'tacocat'.substring(4)    // returns 'cat'
'tacocat'.substring(0, 4) // returns 'taco'
'tacocat'.substring(-1)   // error
'tacocat'.substring(2, 1) // error

trim

Returns a new string that removes the leading and trailing whitespace in the target string. The trim function uses the Unicode definition of whitespace, which does not include the zero-width spaces. See: https://en.wikipedia.org/wiki/Whitespace_character#Unicode

<string>.trim() -> <string>

Examples

'  \ttrim\n    '.trim() // returns 'trim'

upperAscii

Returns a new string where all ASCII characters are upper-cased. This function does not perform Unicode case-mapping for characters outside the ASCII range.

<string>.upperAscii() -> <string>

Examples

'TacoCat'.upperAscii()      // returns 'TACOCAT'
'TacoCÆt Xii'.upperAscii()  // returns 'TACOCÆT XII'

Bitwise

The bitwise operators work at the level of individual bits. All functions expect one or two number arguments that are internally compared bit to bit. The maximum number you can pass is a 64-bit (ignoring the highest bit). Notice that when comparing bits with claims or values found elsewhere, you might need to cast values to integer first.

bitAnd

Returns the result of a bitwise AND binary operation comparing each pair of the corresponding bits. When bits in the same position are both 1, the bit resulting in the binary representation is 1.

bitAnd(<int>, <int>) -> <int>

Examples

bitAnd(6, 1) // returns 0, because 110 AND 001 becomes 000
bitAnd(4, 6) // returns 4, because 100 AND 110 becomes 100
bitAnd(5, 1) // returns 1, because 101 AND 001 becomes 001

bitOr

Returns the result of a bitwise OR (inclusive OR) binary operation comparing each pair of the corresponding bits. The result in each position is 0 if both bits are 0, otherwise the result is 1.

bitOr(<int>, <int>) -> <int>

Examples

bitOr(6, 1) // returns 7, because 110 AND 001 becomes 111
bitOr(4, 6) // returns 6, because 100 AND 110 becomes 110
bitOr(5, 1) // returns 5, because 101 AND 001 becomes 101

bitXor

Returns the result of a bitwise XOR (exclusive OR) binary operation comparing each pair of the corresponding bits. The result in each position is 1 if only one of the bits is 1, otherwise is 0.

bitXor(<int>, <int>) -> <int>

Examples

bitXor(6, 1) // returns 5, because 110 AND 001 becomes 101
bitXor(4, 6) // returns 2, because 100 AND 110 becomes 010
bitXor(5, 1) // returns 4, because 101 AND 001 becomes 100

bitNot

Returns the result of a bitwise NOT (or bitwise complement) that performs the logical negation on each pair of the corresponding bits. Bits that are 1 become 0 and vice-versa. You need a 64-bit calculator to understand the following examples.

bitNot(<int>) -> <int>

Examples

bitNot(2264546456654) // returns 9223349772308319153
bitNot(9223349772308319153) // returns 22264546456654

Headers and query strings

has

Checks if a specific header or query string has a specific key containing a non-empty value. To be used with req_headers and req_querystring. All keys and values must be accessed as strings. Extends the functionality of the built-in has function.

has(<map<string,list<string>>>, <string>) -> <bool>
<map<string,list<string>>>.has(<string>) -> <bool>

Examples

// With a request passing a header "Content-Type: application/json"
req_headers.has("Content-Type") // returns true
req_headers.has("X-Unknown") // returns false
has(req_headers,"Content-Type") // returns true
has(req_headers,"X-Unknown") // returns false

// With a request /endpoint?a[]=1&a[]=2&b=3&c=5&d=
req_querystring.has("a") // returns true
req_querystring.has("d") // returns false
has(req_querystring, "f") // returns false

hasHeader

Checks if a specific header exists in the request. The endpoint must declare it in the input_headers list.

hasHeader(<string>) -> <bool>

Examples

hasHeader("") // returns false
hasHeader("User-Agent") // returns true
hasHeader("X-Invented-Header") // returns false

hasCookie

Checks if a specific non-empty cookie exists (the endpoint must declare the header Cookie in the input_headers list)|

hasCookie(<string>) -> <bool>

Examples

// With these three cookie headers sent: ["foo=bar;foobar=1", "name=value;a=b;c=1", "empty= "]
hasCookie("foo") // returns true
hasCookie("c") // returns true
hasCookie("empty") // returns false
hasCookie("unknown") // returns false

hasHeader

Checks if a specific header exists in the request. The endpoint must declare it in the input_headers list.

hasHeader(<string>) -> <bool>

Examples

hasHeader("") // returns false
hasHeader("User-Agent") // returns true
hasHeader("X-Invented-Header") // returns false

hasQuerystring

Checks if a specific non-empty query string exists (the endpoint must declare the query string in the input_query_strings list)

hasQuerystring(<string>) -> <bool>

Examples

// With a request /endpoint?a[]=1&a[]=2&b=3&c=5&d=
hasQuerystring("a") // returns true
hasQuerystring("c") // returns true
hasQuerystring("d") // returns false
hasQuerystring("unknown") // returns false

getHeader

Returns the value of a specific header if exists, otherwise returns an error. The endpoint must include this header in the input_headers list.

getHeader(<string>) -> <string>

Examples

// With a request passing a header "Content-Type: application/json"
getHeader("Content-Type") // returns "application/json"
getHeader("unknown") // returns an error

getCookie

Checks if a specific non-empty cookie exists. The endpoint must declare the header Cookie in the input_headers list.

getCookie(<string>) -> <string>

Examples

// With these three cookie headers sent: ["foo=bar;foobar=1", "name=value;a=b;c=1", "empty= "]
getCookie("foo") // returns "bar"
getCookie("name") // returns "value"
getCookie("emtpy") // returns ""
getCookie("unknown") // returns an error

contains

Checks if a specific object contains in a key a specific value. It is designed to work with the types of req_headers and req_querystring. All keys and values must be accessed as strings.

contains(<map<string,list<string>>>, <string>, <string>) -> <bool>
<map<string,list<string>>>.contains(<string>, <string>) -> <bool>

Examples

req_headers.contains("Content-Type", "application/json") // returns true when this header is set
req_querystring.contains("foo", "bar") // returns true when ?foo=bar
object.contains("b", "bar") // returns true when object = {"a":["foo"], "b":["bar"]}
contains(object, "b", "bar") // returns true when object = {"a":["foo"], "b":["bar"]}
object.contains("a", "vaz") // returns false when object = {"a":["foo"], "b":["bar"]}
contains(object, "a", "vaz") // returns false when object = {"a":["foo"], "b":["bar"]}

containsCookie

Checks if a specific cookie name contains a specific value. To be used with req_headers. All keys and values must be accessed as strings.

containsCookie(<map<string,list<string>>>, <string>, <string>) -> <bool>
<map<string,list<string>>>.containsCookie(<string>, <string>) -> <bool>

Examples

// With these three cookie headers sent: ["foo=bar;foobar=1", "name=value;a=b;c=1", "empty= "]
req_headers.containsCookie("foo", "bar") // returns true
req_headers.containsCookie("name", "value") // returns true
containsCookie(req_headers, "foo", "something") // returns false
containsCookie(req_headers, "unknown", "something") // returns false
containsCookie(req_headers, "empty", "") // returns true

geoIP

Returns all the information provided by the GeoIP plugin. The contents are determined by the ability of MaxMind’s database to return the information.

geoIP() -> <dyn>

Examples

// With the GeoIP plugin enabled
geoIP().Country.IsoCode in ["US","UK","AU"] // returns true if user is from the US
geoIP().RepresentedCountry.IsInEuropeanUnion // returns false if user is from the US

Lists and collections

collate

Providing one or more paths of a list, returns a new list with the elements matching the path.

<list<dyn>>.collate(<string>) -> <list<dyn>>
<list<dyn>>.collate(<list<string>>) -> <list<dyn>>
<map<string,dyn>>.collate(<string>) -> <list<dyn>>
<map<string,dyn>>.collate(<list<string>>) -> <list<dyn>>

Examples

//  Given v:
//  {
//          "a": [
//              {"b": 1},
//              {"b": 2},
//              {"b": 3}
//          ],
//          "c": [
//              {"d": -1, "c": 10},
//              {"d": -2, "c": 20},
//              {"d": -3, "c": 30}
//          ]
//  }
v.collate("a")             // returns [{"b": 1}, {"b": 2}, {"b": 3}]
v.collate("a.b")           // returns [1, 2, 3]
v.collate(["a.b", "c.d"])  // returns [1, 2, 3, -1, -2, -3]
v.collate(["a", "c.d"])    // returns [{"b": 1 }, {"b": 2 }, {"b": 3 }, -1, -2, -3 ]

drop

Providing one or more paths of a list, returns a new list removing all matching paths.

<list<dyn>>.drop(<string>) -> <list<dyn>>
<list<dyn>>.drop(<list<string>>) -> <list<dyn>>
<map<string,dyn>>.drop(<string>) -> <map<string,dyn>>
<map<string,dyn>>.drop(<list<string>>) -> <map<string,dyn>>

Examples

//  Given v:
//  {
//          "a": [
//              {"b": 1},
//              {"b": 2},
//              {"b": 3}
//          ],
//          "b": [
//              {"b": -1, "c": 10},
//              {"b": -2, "c": 20},
//              {"b": -3, "c": 30}
//          ]
//  }
v.drop("a")             // returns {"b": [{"b": -1, "c": 10}, {"b": -2, "c": 20}, {"b": -3, "c": 30}]}
v.drop("a.b")           // returns {"a": [{}, {}, {}], "b": [{"b": -1, "c": 10}, {"b": -2, "c": 20}, {"b": -3, "c": 30}]}
v.drop(["a.b", "b.b"])  // returns {"a": [{}, {}, {}], "b": [{"c": 10}, {"c": 20}, {"c": 30}]}
v.drop(["a", "b.b"])    // returns {"b": [{"c": 10}, {"c": 20}, {"c": 30}]}

dropEmpty

Providing an object, removes any element considered empty

<list<dyn>>.dropEmpty() -> <list<dyn>>
<map<string,dyn>>.dropEmpty() -> <map<string,dyn>>

Examples

//  Given v:
//  {
//          "a": [
//              {},
//              {},
//              {}
//          ],
//          "b": [
//              {"b": -1, "c": 10},
//              {"b": -2, "c": 20},
//              {"b": -3, "c": 30}
//          ]
//  }
//
v.dropEmpty()  // returns {"b":[{"b":-1, "c":10}, {"b":-2, "c":20}, {"b":-3, "c":30}]}

flatten

Flattens an array returning a list of values resulting from the depth-first traversal of all nested lists.

<list<dyn>...>.flatten() -> <list<dyn>>

Examples

[[1],[2,3],[[[4]],[5,6]]].flatten()                     // returns [1, 2, 3, 4, 5, 6]
[[{"a":1,"b":[10, 11]}],[2,3],[[[4]],[5,6]]].flatten()  // returns [{"a":1, "b":[10, 11]}, 2, 3, 4, 5, 6]

merge

Merges two objects in a single one, taking precedence the one passed as value.

<map<K,V>>.merge(<map<K,V>>) -> <map<K,V>>

Examples

{"a":1, "b":2}.merge({"a":10, "c":3})  // returns {"a":10, "b":2, "c":3}
resp_data.merge(JWT)  // returns all the JWT data and response data together

isSorted

Returns true if the provided list of comparable elements is sorted, else returns false.

<list<T>>.isSorted() -> <bool>, T must be a comparable type

Examples

[1, 2, 3].isSorted()  // returns true
['a', 'b', 'b', 'c'].isSorted()  // returns true
[2.0, 1.0].isSorted()  // returns false
[1].isSorted()  // returns true
[].isSorted()  // returns true

sum

Returns the sum of the elements of the provided list. Supports CEL number (int, uint, double) and duration types.

<list<T>>.sum() -> <T>, T must be a numeric type or a duration

Examples

[1, 3].sum() // returns 4
[1.0, 3.0].sum() // returns 4.0
['1m', '1s'].sum() // returns '1m1s'
emptyIntList.sum() // returns 0
emptyDoubleList.sum() // returns 0.0
[].sum() // returns 0

min

Returns the minimum valued element of the provided list. Supports all comparable types. If the list is empty, an error is returned.

<list<T>>.min() -> <T>, T must be a comparable type

Examples

[1, 3].min() // returns 1
[].min() // error
[1].min() // returns 1
([0] + emptyList).min() // returns 0
["foo", "bar"].min() // returns "bar"

max

Returns the maximum valued element of the provided list. Supports all comparable types. If the list is empty, an error is returned.

<list<T>>.max() -> <T>, T must be a comparable type

Examples

[3, 0.7, 1].max() // returns 3
[1.3, 1.4].max() // returns 1.4
["foo", "bar"].max() // returns "foo"

indexOf

Returns the first positional index of the provided element in the list. If the element is not found, -1 is returned. Supports all equatable types.

<list<T>>.indexOf(<T>) -> <int>, T must be an equatable type

Examples

[1, 2, 2, 3].indexOf(2) // returns 1
['a', 'b', 'b', 'c'].indexOf('a') // returns 0
[1.0].indexOf(1.1) // returns -1
[].indexOf('string') // returns -1

lastIndexOf

Returns the last positional index of the provided element in the list. If the element is not found, -1 is returned. Supports all equatable types.

<list<T>>.lastIndexOf(<T>) -> <int>, T must be an equatable type

Examples

[1, 2, 2, 3].lastIndexOf(2) // returns 2
['a', 'b', 'b', 'c'].lastIndexOf('b') // returns 2
[1.0].lastIndexOf(1.1) // returns -1
[].lastIndexOf('string') // returns -1

URL

url

Converts a string to a URL or results in an error if the string is not a valid URL. The URL must be an absolute URI or an absolute path.

url(<string>) -> <URL>

Examples

url('https://user:[email protected]:80/path?query=val#fragment') // returns a URL
url('/absolute-path') // returns a URL
url('https://a:b:c/') // error
url('../relative-path') // error

isURL

Returns true if a string is a valid URL. The URL must be an absolute URI or an absolute path.

isURL(<string>) -> <bool>

Examples

isURL('https://user:[email protected]:80/path?query=val#fragment') // returns true
isURL('/absolute-path') // returns true
isURL('https://a:b:c/') // returns false
isURL('../relative-path') // returns false

getScheme

Returns the scheme of an URL or an empty string when absent.

<URL>.getScheme() -> <string>

Examples

url('/path').getScheme() // returns ''
url('https://example.com/').getScheme() // returns 'https'

getHost

Returns the host of an URL or an empty string when absent. IPv6 addresses are returned with braces, e.g. [::1].

<URL>.getHost() -> <string>

Examples

url('https://example.com:80/').getHost() // returns 'example.com:80'
url('https://example.com/').getHost() // returns 'example.com'
url('https://[::1]:80/').getHost() // returns '[::1]:80'
url('https://[::1]/').getHost() // returns '[::1]'
url('/path').getHost() // returns ''

getHostname

Returns the host name of an URL or an empty string when absent. IPv6 addresses are returned without braces, e.g. ::1

<URL>.getHostname() -> <string>

Examples

url('https://example.com:80/').getHostname() // returns 'example.com'
url('https://127.0.0.1:80/').getHostname() // returns '127.0.0.1'
url('https://[::1]:80/').getHostname() // returns '::1'
url('/path').getHostname() // returns ''

getPort

Returns the port of an URL or an empty string when absent.

<URL>.getPort() -> <string>

Examples

url('https://example.com:80/').getPort() // returns '80'
url('https://example.com/').getPort() // returns ''
url('/path').getPort() // returns ''

getEscapedPath

Returns the escaped URL or an empty string when absent.. E.g., with space becomes with%20space.

<URL>.getEscapedPath() -> <string>

Examples

url('https://example.com/path').getEscapedPath() // returns '/path'
url('https://example.com/path with spaces/').getEscapedPath() // returns '/path%20with%20spaces/'
url('https://example.com').getEscapedPath() // returns ''

getQuery

Returns the query parameters in “matrix” form where a repeated query key is interpreted to mean that there are multiple values for that key. The keys and values are returned unescaped. If absent in the URL, returns an empty map.

<URL>.getQuery() -> <map <string>, <list <string>>

Examples

url('https://example.com/path?k1=a&k2=b&k2=c').getQuery() // returns { 'k1': ['a'], 'k2': ['b', 'c']}
url('https://example.com/path?key with spaces=value with spaces').getQuery() // returns { 'key with spaces': ['value with spaces']}
url('https://example.com/path?').getQuery() // returns {}
url('https://example.com/path').getQuery() // returns {}

Encoding

toJSON

Returns the JSON representation of an object.

toJSON(<dyn>) -> <string>
<dyn>.toJSON() -> <string>

Examples

{"foo":1, "bar":[1, 2, 3]}.toJSON()  // returns "{\"foo\":1,\"bar\":[1,2,3]}"
toJSON({"foo":1, "bar":[1, 2, 3]})   // returns "{\"foo\":1,\"bar\":[1,2,3]}"

fromJSON

Returns an object from a JSON representation.

<bytes>.fromJSON() -> <dyn>
<string>.fromJSON() -> <dyn>
fromJSON(<bytes>) -> <dyn>
fromJSON(<string>) -> <dyn>

Examples

"{\"foo\":1,\"bar\":[1,2,3]}".fromJSON()   // returns {"foo":1, "bar":[1, 2, 3]}
"{\"a\":1,\"bar\":[1,2,3]}".fromJSON()  // returns {"a":1, "bar":[1, 2, 3]}

fromJSONStream

Returns a list of objects from a JSON stream.

<bytes>.fromJSONStream() -> <list<dyn>>
<string>.fromJSONStream() -> <list<dyn>>
fromJSONStream(<bytes>) -> <list<dyn>>
fromJSONStream(<string>) -> <list<dyn>>

Examples

'{"foo":1}{"bar":2}'.fromJSONStream()   // returns [{"foo":1}, {"bar":2}]
'{"foo":1}{"bar":2}'.fromJSONStream()  // returns [{"foo":1}, {"bar":2}]

base64

Returns the base64 encoding of a string or array of bytes

base64(<bytes>) -> <string>
base64(<string>) -> <string>
<bytes>.base64() -> <string>
<string>.base64() -> <string>

Examples

"hello world".base64()  // returns "aGVsbG8gd29ybGQ="

base64Raw

Returns the base64 encoding of a string or array of bytes

base64Raw(<bytes>) -> <string>
base64Raw(<string>) -> <string>
<bytes>.base64Raw() -> <string>
<string>.base64Raw() -> <string>

Examples

"hello world".base64Raw()  // returns "aGVsbG8gd29ybGQ"

hex

Returns the base64 encoding of a string or array of bytes

hex(<bytes>) -> <string>
hex(<string>) -> <string>
<bytes>.hex() -> <string>
<string>.hex() -> <string>

Examples

"hello world".hex()  // returns "68656c6c6f20776f726c64"

Cryptography

sha1

Returns the SHA1 of a string or array of bytes

sha1(<bytes>) -> <bytes>
sha1(<string>) -> <bytes>
<bytes>.sha1() -> <bytes>
<string>.sha1() -> <bytes>

Examples

"hello world".sha1()       // returns "Kq5sNclPz7QV2+lfQIuc6R7oRu0="
"hello world".sha1().hex() // returns "2aae6c35c94fcfb415dbe95f408b9ce91ee846ed"

sha256

Returns the SHA2 of a string or array of bytes

sha256(<bytes>) -> <bytes>
sha256(<string>) -> <bytes>
<bytes>.sha256() -> <bytes>
<string>.sha256() -> <bytes>

Examples

"hello world".sha256()        // returns "uU0nuZNNPgilLlLX2n2r+sSE7+N6U4DukIj3rOLvzek="
"hello world".sha256().hex()  // returns "b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9"

hmac

Returns the HMAC of a string or array of bytes

hmac(<bytes>, <string>, <bytes>) -> <bytes>
hmac(<string>, <string>, <bytes>) -> <bytes>
<bytes>.hmac(<string>, <bytes>) -> <bytes>
<string>.hmac(<string>, <bytes>) -> <bytes>

Examples

"hello world".hmac("sha256", b"key")        // returns "C6BvH5pjAEYeQ0VFNdw8QiPkex01cHPXU26ukOwJW+E="
"hello world".hmac("sha256", b"key").hex()  // returns "0ba06f1f9a6300461e43454535dc3c4223e47b1d357073d7536eae90ec095be1"

uuid

Returns a random UUID v4 string

uuid() -> <string>

Examples

uuid()  // returns "582fc58b-f983-4c35-abb1-65c507c1dc0c"