docs: added reference for JS Client (#1629)

* added reference for JS Client

* added reference for JS Client

* added reference for JS Client
This commit is contained in:
Shahed Nasser
2022-07-08 18:21:46 +03:00
committed by GitHub
parent 371682b4f7
commit 3b28f46705
357 changed files with 32911 additions and 3 deletions

View File

@@ -0,0 +1,186 @@
---
displayed_sidebar: jsClientSidebar
---
# Class: Client
[internal](../modules/internal.md).Client
## Properties
### axiosClient
`Private` **axiosClient**: [`AxiosInstance`](../interfaces/internal.AxiosInstance.md)
#### Defined in
[packages/medusa-js/src/request.ts:29](https://github.com/medusajs/medusa/blob/2eb2126f/packages/medusa-js/src/request.ts#L29)
___
### config
`Private` **config**: [`Config`](../interfaces/internal.Config.md)
#### Defined in
[packages/medusa-js/src/request.ts:30](https://github.com/medusajs/medusa/blob/2eb2126f/packages/medusa-js/src/request.ts#L30)
## Methods
### createClient
**createClient**(`config`): [`AxiosInstance`](../interfaces/internal.AxiosInstance.md)
Creates the axios client used for requests
As part of the creation, we configure the retry conditions
and the exponential backoff approach.
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `config` | [`Config`](../interfaces/internal.Config.md) | user supplied configurations |
#### Returns
[`AxiosInstance`](../interfaces/internal.AxiosInstance.md)
#### Defined in
[packages/medusa-js/src/request.ts:146](https://github.com/medusajs/medusa/blob/2eb2126f/packages/medusa-js/src/request.ts#L146)
___
### normalizeHeader
**normalizeHeader**(`header`): `string`
#### Parameters
| Name | Type |
| :------ | :------ |
| `header` | `string` |
#### Returns
`string`
#### Defined in
[packages/medusa-js/src/request.ts:83](https://github.com/medusajs/medusa/blob/2eb2126f/packages/medusa-js/src/request.ts#L83)
___
### normalizeHeaders
**normalizeHeaders**(`obj`): [`Record`](../modules/internal.md#record)<`string`, `any`\>
#### Parameters
| Name | Type |
| :------ | :------ |
| `obj` | `object` |
#### Returns
[`Record`](../modules/internal.md#record)<`string`, `any`\>
#### Defined in
[packages/medusa-js/src/request.ts:71](https://github.com/medusajs/medusa/blob/2eb2126f/packages/medusa-js/src/request.ts#L71)
___
### request
**request**(`method`, `path`, `payload?`, `options?`, `customHeaders?`): [`Promise`](../modules/internal.md#promise)<`any`\>
Axios request
#### Parameters
| Name | Type | Default value | Description |
| :------ | :------ | :------ | :------ |
| `method` | [`RequestMethod`](../modules/internal.md#requestmethod) | `undefined` | request method |
| `path` | `string` | `undefined` | request path |
| `payload` | ``null`` \| [`Record`](../modules/internal.md#record)<`string`, `any`\> | `null` | request payload |
| `options` | [`RequestOptions`](../interfaces/internal.RequestOptions.md) | `{}` | axios configuration |
| `customHeaders` | [`Record`](../modules/internal.md#record)<`string`, `any`\> | `{}` | custom request headers |
#### Returns
[`Promise`](../modules/internal.md#promise)<`any`\>
#### Defined in
[packages/medusa-js/src/request.ts:183](https://github.com/medusajs/medusa/blob/2eb2126f/packages/medusa-js/src/request.ts#L183)
___
### requiresAuthentication
▸ **requiresAuthentication**(`path`, `method`): `boolean`
#### Parameters
| Name | Type |
| :------ | :------ |
| `path` | `any` |
| `method` | `any` |
#### Returns
`boolean`
#### Defined in
[packages/medusa-js/src/request.ts:92](https://github.com/medusajs/medusa/blob/2eb2126f/packages/medusa-js/src/request.ts#L92)
___
### setHeaders
▸ **setHeaders**(`userHeaders`, `method`, `path`, `customHeaders?`): [`AxiosRequestHeaders`](../modules/internal.md#axiosrequestheaders)
Creates all the initial headers.
We add the idempotency key, if the request is configured to retry.
#### Parameters
| Name | Type | Description |
| :------ | :------ | :------ |
| `userHeaders` | [`RequestOptions`](../interfaces/internal.RequestOptions.md) | user supplied headers |
| `method` | [`RequestMethod`](../modules/internal.md#requestmethod) | request method |
| `path` | `string` | request path |
| `customHeaders` | [`Record`](../modules/internal.md#record)<`string`, `any`\> | user supplied headers |
#### Returns
[`AxiosRequestHeaders`](../modules/internal.md#axiosrequestheaders)
#### Defined in
[packages/medusa-js/src/request.ts:108](https://github.com/medusajs/medusa/blob/2eb2126f/packages/medusa-js/src/request.ts#L108)
___
### shouldRetryCondition
▸ **shouldRetryCondition**(`err`, `numRetries`, `maxRetries`): `boolean`
#### Parameters
| Name | Type |
| :------ | :------ |
| `err` | [`AxiosError`](../interfaces/internal.AxiosError.md)<`any`, `any`\> |
| `numRetries` | `number` |
| `maxRetries` | `number` |
#### Returns
`boolean`
#### Defined in
[packages/medusa-js/src/request.ts:40](https://github.com/medusajs/medusa/blob/2eb2126f/packages/medusa-js/src/request.ts#L40)