Skip to content

node-zendesk • Docs


node-zendesk / clients/core/locales / Locales

Class: Locales ​

Represents the Locales endpoint of the Zendesk REST API wrapper.

See ​

https://developer.zendesk.com/api-reference/ticketing/account-configuration/locales/

Extends ​

Constructors ​

new Locales() ​

new Locales(options): Locales

Parameters ​

• options: any

Returns ​

Locales

Overrides ​

Client.constructor

Defined in ​

clients/core/locales.d.ts:6

Properties ​

_transporter ​

_transporter: Transporter

Inherited from ​

Client._transporter

Defined in ​

clients/client.d.ts:42


eventTarget ​

eventTarget: CustomEventTarget

Event target to handle custom events.

Inherited from ​

Client.eventTarget

Defined in ​

clients/client.d.ts:40


jsonAPINames ​

jsonAPINames: string[]

Array to hold names used in the JSON API.

Overrides ​

Client.jsonAPINames

Defined in ​

clients/core/locales.d.ts:7


options ​

options: ZendeskClientOptions & object

Configuration options for the client.

Type declaration ​

get() ​

get: (key) => any

Parameters ​

• key: string

Returns ​

any

Inherited from ​

Client.options

Defined in ​

clients/client.d.ts:34


sideLoad ​

sideLoad: any[]

Array to handle side-loaded resources.

Inherited from ​

Client.sideLoad

Defined in ​

clients/client.d.ts:37


useDotJson ​

useDotJson: boolean

Flag to indicate if the API endpoint should use '.json' ending.

Inherited from ​

Client.useDotJson

Defined in ​

clients/client.d.ts:39

Accessors ​

transporter ​

Get Signature ​

get transporter(): Transporter

Returns ​

Transporter

Transporter for making requests.

Inherited from ​

Client.transporter

Defined in ​

clients/client.d.ts:41

Methods ​

_rawRequest() ​

_rawRequest(method, uri, ...arguments_): Promise<object>

Parameters ​

• method: any

• uri: any

• ...arguments_: any[]

Returns ​

Promise<object>

response ​

response: any

result ​

result: object

Inherited from ​

Client._rawRequest

Defined in ​

clients/client.d.ts:78


current() ​

current(): Promise<object>

Alias for showCurrent. Retrieves the locale information of the currently logged-in user.

Returns ​

Promise<object>

Details of the current user's locale.

response ​

response: object

result ​

result: object

Throws ​

Throws an error if the API request fails.

See ​

https://developer.zendesk.com/api-reference/ticketing/account-configuration/locales/#show-current-locale

Example ​

ts
const client = createClient({...});
const currentLocale = await client.locales.current();

Defined in ​

clients/core/locales.d.ts:54


delete() ​

delete(...arguments_): Promise<void | object>

Deletes a resource.

Parameters ​

• ...arguments_: any[]

The resources or parts of the resource path.

Returns ​

Promise<void | object>

  • Either void or response object

Inherited from ​

Client.delete

Defined in ​

clients/client.d.ts:76


detectBestLocale() ​

detectBestLocale(availableLocales): Promise<object>

Detects the best language/locale for the user based on provided available locales.

Parameters ​

• availableLocales: string[]

Array of available locales e.g., ['es', 'ja', 'en-uk'].

Returns ​

Promise<object>

Best detected locale for the user.

response ​

response: object

result ​

result: object

Throws ​

Throws an error if the API request fails.

See ​

https://developer.zendesk.com/api-reference/ticketing/account-configuration/locales/#detect-best-language-for-user

Example ​

ts
const client = createClient({...});
const bestLocale = await client.locales.detectBestLocale(['es', 'ja', 'en-uk']);

Defined in ​

clients/core/locales.d.ts:88


emit() ​

emit(eventType, eventData): void

Parameters ​

• eventType: any

• eventData: any

Returns ​

void

Inherited from ​

Client.emit

Defined in ​

clients/client.d.ts:43


get() ​

get(resource): Promise<NodeModule>

Parameters ​

• resource: any

Returns ​

Promise<NodeModule>

Inherited from ​

Client.get

Defined in ​

clients/client.d.ts:62


getAll() ​

getAll(resource): Promise<any[]>

Parameters ​

• resource: any

Returns ​

Promise<any[]>

Inherited from ​

Client.getAll

Defined in ​

clients/client.d.ts:77


list() ​

list(): Promise<object[]>

Lists all the translation locales available for the account.

Returns ​

Promise<object[]>

List of locales.

Throws ​

Throws an error if the API request fails.

See ​

https://developer.zendesk.com/api-reference/ticketing/account-configuration/locales/#list-locales

Example ​

ts
const client = createClient({...});
const locales = await client.locales.list();

Defined in ​

clients/core/locales.d.ts:17


listForAgent() ​

listForAgent(): Promise<object[]>

Lists the translation locales that have been localized for agents on a specific account.

Returns ​

Promise<object[]>

List of locales available for agents.

Throws ​

Throws an error if the API request fails.

See ​

https://developer.zendesk.com/api-reference/ticketing/account-configuration/locales/#list-locales-for-agent

Example ​

ts
const client = createClient({...});
const agentLocales = await client.locales.listForAgent();

Defined in ​

clients/core/locales.d.ts:67


listPublicLocales() ​

listPublicLocales(): Promise<object[]>

Lists the translation locales that are available to all accounts.

Returns ​

Promise<object[]>

List of public locales available to all accounts.

Throws ​

Throws an error if the API request fails.

See ​

https://developer.zendesk.com/api-reference/ticketing/account-configuration/locales/#list-available-public-locales

Example ​

ts
const client = createClient({...});
const publicLocales = await client.locales.listPublicLocales();

Defined in ​

clients/core/locales.d.ts:77


on() ​

on(eventType, callback): void

Parameters ​

• eventType: any

• callback: any

Returns ​

void

Inherited from ​

Client.on

Defined in ​

clients/client.d.ts:44


patch() ​

patch(...arguments_): Promise<void | object>

Patches a resource.

Parameters ​

• ...arguments_: any[]

The resources or parts of the resource path followed by the body.

Returns ​

Promise<void | object>

  • Either void or response object

Inherited from ​

Client.patch

Defined in ​

clients/client.d.ts:68


post() ​

post(resource, body): Promise<NodeModule>

Parameters ​

• resource: any

• body: any

Returns ​

Promise<NodeModule>

Inherited from ​

Client.post

Defined in ​

clients/client.d.ts:70


put() ​

put(resource, body): Promise<NodeModule>

Parameters ​

• resource: any

• body: any

Returns ​

Promise<NodeModule>

Inherited from ​

Client.put

Defined in ​

clients/client.d.ts:69


request() ​

request<T>(method, uri, ...arguments_): Promise<NodeModule>

Request method that handles various HTTP methods.

Type Parameters ​

• T

Parameters ​

• method: string

HTTP method (e.g., 'GET', 'POST').

• uri: string

The URI for the request.

• ...arguments_: any[]

Additional arguments for the request.

Returns ​

Promise<NodeModule>

  • The API response.

Inherited from ​

Client.request

Defined in ​

clients/client.d.ts:96


requestAll() ​

requestAll(method, uri, ...arguments_): Promise<any[]>

Parameters ​

• method: any

• uri: any

• ...arguments_: any[]

Returns ​

Promise<any[]>

Inherited from ​

Client.requestAll

Defined in ​

clients/client.d.ts:97


requestUpload() ​

requestUpload(uri, file): Promise<any>

Parameters ​

• uri: any

• file: any

Returns ​

Promise<any>

Inherited from ​

Client.requestUpload

Defined in ​

clients/client.d.ts:98


setSideLoad() ​

setSideLoad(array): void

Parameters ​

• array: any

Returns ​

void

Inherited from ​

Client.setSideLoad

Defined in ​

clients/client.d.ts:61


show() ​

show(localeID): Promise<object>

Retrieves information about a specific locale based on the localeID.

Parameters ​

• localeID: string | number

The ID or the BCP-47 code of the locale (e.g., 'en-US', 'es-419').

Returns ​

Promise<object>

Details of the specified locale.

response ​

response: object

result ​

result: object

Throws ​

Throws an error if the API request fails.

See ​

https://developer.zendesk.com/api-reference/ticketing/account-configuration/locales/#show-locale

Example ​

ts
const client = createClient({...});
const locale = await client.locales.show('en-US');

Defined in ​

clients/core/locales.d.ts:28


showCurrent() ​

showCurrent(): Promise<object>

Retrieves the locale information of the currently logged-in user.

Returns ​

Promise<object>

Details of the current user's locale.

response ​

response: object

result ​

result: object

Throws ​

Throws an error if the API request fails.

See ​

https://developer.zendesk.com/api-reference/ticketing/account-configuration/locales/#show-current-locale

Example ​

ts
const client = createClient({...});
const currentLocale = await client.locales.showCurrent();

Defined in ​

clients/core/locales.d.ts:41

Released under the MIT License.