src/shared/api/rest/requests.ts - master - viktorphp/front-socket

src/shared/api/rest/requests.ts
100 строк4 KB
Иванов Виктор Евгеньевич
[feature-diary]: поправить баги и верстку, добавить README.md
12 апр 2026, 20:01
12 апр 2026, 20:010d63759
import { AxiosRequestConfig, AxiosResponse } from 'axios';

import { instance } from './instance';

/**
 * @function post - Отправляет POST-запрос.
 * @param { string } url - url для отправки запроса.
 * @param { any } data - Данные запроса.
 * @param { AxiosRequestConfig<any> } config - Дополнительные настройки запроса.
 * @returns { Promise<AxiosResponse<any>> } - Ответ от сервера.
 */
function post<T = any, R = AxiosResponse<T>, D = any>(
  url: string,
  data?: any,
  config?: AxiosRequestConfig<D> & { headers?: Record<string, string> }
): Promise<R> {
  return instance.post(url, data, {
    ...config,
    headers: {
      ...instance.defaults.headers.common, // сохраняем дефолтные заголовки
      ...config?.headers, // добавляем переданные заголовки
    },
  });
}

/**
 * @function get - Отправляет GET-запрос.
 * @param { string } url - url для отправки запроса.
 * @param { AxiosRequestConfig<any> } config - Дополнительные настройки запроса.
 * @returns { Promise<AxiosResponse<any>> } - Ответ от сервера.
 */
function get<T = any, R = AxiosResponse<T>, D = any>(
  url: string,
  config?: AxiosRequestConfig<D> & { headers?: Record<string, string> }
): Promise<R> {
  return instance.get(url, {
    ...config,
    headers: {
      ...instance.defaults.headers.common, // сохраняем дефолтные заголовки
      ...config?.headers, // добавляем переданные заголовки
    },
  });
}

/**
 * @function del - Отправляет DELETE-запрос.
 * @param { string } url - url для отправки запроса.
 * @param { AxiosRequestConfig<any> } config - Дополнительные настройки запроса.
 * @returns { Promise<AxiosResponse<any>> } - Ответ от сервера.
 */
function del<T = any, R = AxiosResponse<T>, D = any>(
  url: string,
  config?: AxiosRequestConfig<D>
): Promise<R> {
  return instance.delete(url, config);
}

/**
 * @function put - Отправляет PUT-запрос.
 * @param { string } url - url для отправки запроса.
 * @param { any } data - Данные запроса.
 * @param { AxiosRequestConfig<any> } config - Дополнительные настройки запроса.
 * @returns { Promise<AxiosResponse<any>> } - Ответ от сервера.
 */
function put<T = any, R = AxiosResponse<T>, D = any>(
  url: string,
  data?: any,
  config?: AxiosRequestConfig<D> & { headers?: Record<string, string> }
): Promise<R> {
  return instance.put(url, data, {
    ...config,
    headers: {
      ...instance.defaults.headers.common, // сохраняем дефолтные заголовки
      ...config?.headers, // добавляем переданные заголовки
    },
  });
}

/**
 * @function patch - Отправляет PATCH-запрос.
 * @param { string } url - url для отправки запроса.
 * @param { any } data - Данные запроса.
 * @param { AxiosRequestConfig<any> } config - Дополнительные настройки запроса.
 * @returns { Promise<AxiosResponse<any>> } - Ответ от сервера.
 */
function patch<T = any, R = AxiosResponse<T>, D = any>(
  url: string,
  data?: any,
  config?: AxiosRequestConfig<D> & { headers?: Record<string, string> }
): Promise<R> {
  return instance.patch(url, data, {
    ...config,
    headers: {
      ...instance.defaults.headers.common,
      ...config?.headers,
    },
  });
}

export { post, get, del, put, patch };