Module: thing/get#

Functions#

getBoolean#

▸ getBoolean(thing, property): boolean | null

Returns the boolean value of the specified Property from a Thing. If the Property is not present or its value is not of type boolean, returns null. If the Property has multiple boolean values, returns one of its values.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read a boolean value from.
`property`	`string` \| `Url`	The Property whose boolean value to return.

Returns#

boolean | null

A boolean value for the given Property if present, or null if the Property is not present or the value is not of type boolean.

Defined in#

src/thing/get.ts:123

getBooleanAll#

▸ getBooleanAll(thing, property): boolean[]

Returns the boolean values of the specified Property from a Thing. If the Property is not present, returns an empty array. If the Property’s value is not of type boolean, omits that value in the array.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read the boolean values from.
`property`	`string` \| `Url`	The Property whose boolean values to return.

Returns#

boolean[]

An array of boolean values for the given Property.

Defined in#

src/thing/get.ts:150

getDate#

▸ getDate(thing, property): Date | null

Returns the date value of the specified Property from a Thing. If the Property is not present or its value is not of type date, returns null. If the Property has multiple date values, returns one of its values.

Since

1.10.0

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read a date value from.
`property`	`string` \| `Url`	The Property whose date value to return.

Returns#

Date | null

A date value for the given Property if present, or null if the Property is not present or the value is not of type date.

Defined in#

src/thing/get.ts:228

getDateAll#

▸ getDateAll(thing, property): Date[]

Returns the date values of the specified Property from a Thing. If the Property is not present, returns an empty array. If the Property’s value is not of type date, omits that value in the array.

Since

1.10.0

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read the date values from.
`property`	`string` \| `Url`	The Property whose date values to return.

Returns#

Date[]

An array of date values for the given Property.

Defined in#

src/thing/get.ts:250

getDatetime#

▸ getDatetime(thing, property): Date | null

Returns the datetime value of the specified Property from a Thing. If the Property is not present or its value is not of type datetime, returns null. If the Property has multiple datetime values, returns one of its values.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read a datetime value from.
`property`	`string` \| `Url`	The Property whose datetime value to return.

Returns#

Date | null

A datetime value for the given Property if present, or null if the Property is not present or the value is not of type datetime.

Defined in#

src/thing/get.ts:175

getDatetimeAll#

▸ getDatetimeAll(thing, property): Date[]

Returns the datetime values of the specified Property from a Thing. If the Property is not present, returns an empty array. If the Property’s value is not of type datetime, omits that value in the array.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read the datetime values from.
`property`	`string` \| `Url`	The Property whose datetime values to return.

Returns#

Date[]

An array of datetime values for the given Property.

Defined in#

src/thing/get.ts:202

getDecimal#

▸ getDecimal(thing, property): number | null

Returns the decimal value of the specified Property from a Thing. If the Property is not present or its value is not of type decimal, returns null. If the Property has multiple decimal values, returns one of its values.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read a decimal value from.
`property`	`string` \| `Url`	The Property whose decimal value to return.

Returns#

number | null

A decimal value for the given Property if present, or null if the Property is not present or the value is not of type decimal.

Defined in#

src/thing/get.ts:316

getDecimalAll#

▸ getDecimalAll(thing, property): number[]

Returns the decimal values of the specified Property from a Thing. If the Property is not present, returns an empty array. If the Property’s value is not of type decimal, omits that value in the array.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read the decimal values from.
`property`	`string` \| `Url`	The Property whose decimal values to return.

Returns#

number[]

An array of decimal values for the given Property.

Defined in#

src/thing/get.ts:343

getInteger#

▸ getInteger(thing, property): number | null

Returns the integer value of the specified Property from a Thing. If the Property is not present or its value is not of type integer, returns null. If the Property has multiple integer values, returns one of its values.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read an integer value from.
`property`	`string` \| `Url`	The Property whose integer value to return.

Returns#

number | null

A integer value for the given Property if present, or null if the Property is not present or the value is not of type datetime.

Defined in#

src/thing/get.ts:368

getIntegerAll#

▸ getIntegerAll(thing, property): number[]

Returns the integer values of the specified Property from a Thing. If the Property is not present, returns an empty array. If the Property’s value is not of type integer, omits that value in the array.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read the integer values from.
`property`	`string` \| `Url`	The Property whose integer values to return.

Returns#

number[]

An array of integer values for the given Property.

Defined in#

src/thing/get.ts:395

getStringByLocaleAll#

▸ getStringByLocaleAll(thing, property): Map<string, string[]>

Returns all localized string values mapped by the locales for the specified property from the specified Thing (explicitly filters out non-language string literals).

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read the localised string values from.
`property`	`string` \| `Url`	The Property whose localised string values to return.

Returns#

Map<string, string[]>

A Map of objects, keyed on locale with the value an array of string values (for that locale).

Defined in#

src/thing/get.ts:518

getStringEnglish#

▸ getStringEnglish(thing, property): string | null

Returns the English (language tag “en”) string value of the specified Property from a Thing. If the Property is not present as a string in English, returns null. If the Property has multiple English string values, returns one of its values.

Since

1.13.0

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read a localised string value from.
`property`	`string` \| `Url`	The Property whose localised string value to return.

Returns#

string | null

An English string value for the given Property if present, or null otherwise.

Defined in#

src/thing/get.ts:421

getStringEnglishAll#

▸ getStringEnglishAll(thing, property): string[]

Returns the English (language tag “en”) string values of the specified Property from a Thing. If the Property is not present, returns an empty array. If the Property’s value is not an English string, omits that value in the array.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read a localised string value from.
`property`	`string` \| `Url`	The Property whose localised string value to return.

Returns#

string[]

An array of English string values for the given Property.

Defined in#

src/thing/get.ts:470

getStringNoLocale#

▸ getStringNoLocale(thing, property): string | null

Returns the string value of the specified Property from a Thing. If the Property is not present or its value is not of type string, returns null. If the Property has multiple string values, returns one of its values.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read a string value from.
`property`	`string` \| `Url`	The Property whose string value to return.

Returns#

string | null

A string value for the given Property if present, or null if the Property is not present or the value is not of type string.

Defined in#

src/thing/get.ts:545

getStringNoLocaleAll#

▸ getStringNoLocaleAll(thing, property): string[]

Returns the string values of the specified Property from a Thing. If the Property is not present, returns an empty array. If the Property’s value is not of type string, omits that value in the array.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read the string values from.
`property`	`string` \| `Url`	The Property whose string values to return.

Returns#

string[]

An array of string values for the given Property.

Defined in#

src/thing/get.ts:568

getStringWithLocale#

▸ getStringWithLocale(thing, property, locale): string | null

Returns the localized string value of the specified Property from a Thing. If the Property is not present as a string in the specified locale, returns null. If the Property has multiple string values for the specified locale, returns one of its values.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read a localised string value from.
`property`	`string` \| `Url`	The Property whose localised string value to return.
`locale`	`string`	The desired locale for the string value.

Returns#

string | null

A localised string value for the given Property if present in the specified locale, or null otherwise.

Defined in#

src/thing/get.ts:438

getStringWithLocaleAll#

▸ getStringWithLocaleAll(thing, property, locale): string[]

Returns the localized string values of the specified Property from a Thing. If the Property is not present, returns an empty array. If the Property’s value is not a string of the specified locale, omits that value in the array.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read the localised string values from.
`property`	`string` \| `Url`	The Property whose localised string values to return.
`locale`	`string`	The desired locale for the string values.

Returns#

string[]

An array of localised string values for the given Property.

Defined in#

src/thing/get.ts:487

getTime#

▸ getTime(thing, property): Time | null

Returns the time value of the specified Property from a Thing. If the Property is not present or its value is not of type time, returns null. If the Property has multiple time values, returns one of its values.

Since

1.10.0

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read a time value from.
`property`	`string` \| `Url`	The Property whose time value to return.

Returns#

Time | null

A time value for the given Property if present, or null if the Property is not present or the value is not of type time.

Defined in#

src/thing/get.ts:273

getTimeAll#

▸ getTimeAll(thing, property): Time[]

Returns the time values of the specified Property from a Thing. If the Property is not present, returns an empty array. If the Property’s value is not of type time, omits that value in the array.

Since

1.10.0

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read the time values from.
`property`	`string` \| `Url`	The Property whose time values to return.

Returns#

Time[]

An array of time values for the given Property.

Defined in#

src/thing/get.ts:294

getUrl#

▸ getUrl(thing, property): UrlString | null

Returns the URL value of the specified Property from a Thing. If the Property is not present or its value is not of type URL, returns null. If the Property has multiple URL values, returns one of its URL values.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read a URL value from.
`property`	`string` \| `Url`	The Property whose URL value to return.

Returns#

UrlString | null

A URL value for the given Property if present, or null if the Property is not present or the value is not of type URL.

Defined in#

src/thing/get.ts:69

getUrlAll#

▸ getUrlAll(thing, property): UrlString[]

Returns the URL values of the specified Property from a Thing. If the Property is not present, returns an empty array. If the Property’s value is not of type URL, omits that value in the array.

Parameters#

Name	Type	Description
`thing`	`Readonly`<{}>	The Thing to read the URL values from.
`property`	`string` \| `Url`	The Property whose URL values to return.

Returns#

UrlString[]

An array of URL values for the given Property.

Defined in#

src/thing/get.ts:96