Vue3 Ajax(axios)

La versión de Vue recomienda usar axios para realizar solicitudes ajax.

Axios es una librería HTTP basada en Promise que puede usarse en el navegador y en Node.js.

Dirección del proyecto de código abierto en GitHub:https://github.com/axios/axios

Método de instalación

Usando CDN:

<script src="https://unpkg.com/axios/dist/axios.min.js"></script>

<script src="https://lf26-cdn-tos.bytecdntp.com/cdn/expire-1-M/axios/0.26.0/axios.min.js" type="application/javascript"></script>

Usando npm:

$ npm install axios

Usando bower:

$ bower install axios

Usando yarn:

$ yarn add axios

Método de uso

Importa el objeto axios exportado por defecto desde el módulo Axios:

import axios from 'axios';

1. Realizar una solicitud GET

Realiza una solicitud para el usuario con el ID especificado:

Ejemplo

axios.get('/user?ID=12345')
.then(function (response) {
// Manejo del éxito
console.log(response);
})
.catch(function (error) {
// Manejo de errores
console.log(error);
})
.finally(function () {
// Siempre se ejecuta
});

La solicitud anterior también se puede implementar así:

Ejemplo

axios.get('/user', {
params: {
ID: 12345
}
})
.then(function (response) {
console.log(response);
})
.catch(function (error) {
console.log(error);
})
.finally(function () {
// Siempre se ejecuta
});

Si deseas usar async/await, agrega la palabra clave async a la función/método externo.

Ejemplo

async function getUser() {
try {
const response = await axios.get('/user?ID=12345');
console.log(response);
} catch (error) {
console.error(error);
}
}

Nota:async/await es parte de ECMAScript 2017 y no es compatible con Internet Explorer ni con navegadores antiguos, por lo tanto úsalo con precaución.

2. Realizar una solicitud POST

Ejemplo

axios.post('/user', {
firstName: 'Fred',
lastName: 'Flintstone'
})
.then(function (response) {
console.log(response);
})
.catch(function (error) {
console.log(error);
});

Ejecutar múltiples solicitudes de forma concurrente:

Ejemplo

Compatibilidad con navegadores

Método GET

Podemos leer datos JSON fácilmente:

Ejemplo GET

const app = { data() { return { info: '¡Prueba de Ajax!!' } }, mounted () { axios .get('https://www.example.com/try/ajax/json_demo.json') .then(response => (this.info = response)) .catch(function (error) { //Manejo de errores de la solicitud console.log(error); }); } } Vue.createApp(app).mount('#app')

Pruébalo »

Usoresponse.dataLeer datos JSON:

Ejemplo GET

<div id="app"> <h1>Lista de sitios web</h1> <div v-for="site in info" > {{ site.name }} </div> </div> <script type = "text/javascript">const app = { data() { return { info: '¡Prueba de Ajax!!' } }, mounted () { axios .get('https://www.example.com/try/ajax/json_demo.json') .then(response => (this.info = response.data.sites)) .catch(function (error) { // Manejo de errores de la solicitud console.log(error); }); } } Vue.createApp(app).mount('#app')</script>

Pruébalo »

El método GET pasa los parámetros de la siguiente manera:

Descripción de los parámetros

//Agrega el parámetro ID=12345 directamente en la URL. axios.get('/user?ID=12345') .then(function (response) { console.log(response); }) .catch(function (error) { console.log(error); }); //También puedes configurar los parámetros mediante params: axios.get('/user', { params: { ID: 12345 } }) .then(function (response) { console.log(response); }) .catch(function (error) { console.log(error); });

Método POST

Ejemplo POST

const app = { data() { return { info: null } }, mounted () { axios .post('https://www.example.com/try/ajax/demo_axios_post.php') .then(response => (this.info = response)) .catch(function (error) { //Manejo de errores de la solicitud console.log(error); }); } } Vue.createApp(app).mount('#app')

Pruébalo »

El método POST pasa los parámetros de la siguiente manera:

Descripción de los parámetros

axios.post('/user', { firstName: 'Fred', //Parámetro firstName lastName: 'Flintstone' //Parámetro lastName }) .then(function (response) { console.log(response); }) .catch(function (error) { console.log(error); });

Realizar múltiples solicitudes concurrentes

Ejemplo

axios API

Puedes crear solicitudes pasando la configuración relevante a axios.

Ejemplo

axios(config) //Enviar solicitud POST axios({ method: 'post', url: '/user/12345', data: { firstName: 'Fred', lastName: 'Flintstone' } }); //Solicitud GET de imagen remota axios({ method:'get', url:'http://bit.ly/2mTM3nY', responseType:'stream' }) .then(function(response) { response.data.pipe(fs.createWriteStream('ada_lovelace.jpg')) }); axios(url[, config]) //Enviar solicitud GET (método predeterminado) axios('/user/12345');

Alias de los métodos de solicitud

Para facilitar su uso, la documentación oficial proporciona alias para todos los métodos de solicitud admitidos, por lo que puedes usar directamente los alias para realizar solicitudes:

axios.request(config)
axios.get(url[, config])
axios.delete(url[, config])
axios.head(url[, config])
axios.post(url[, data[, config]])
axios.put(url[, data[, config]])
axios.patch(url[, data[, config]])

Nota:Al usar métodos de alias, las propiedades url, method y data no necesitan especificarse en la configuración.

Concurrencia

Funciones auxiliares para manejar solicitudes concurrentes:

axios.all(iterable)
axios.spread(callback)

Crear una instancia

Puedes crear una nueva instancia de axios con una configuración personalizada:

axios.create([config])
const instance = axios.create({
  baseURL: 'https://some-domain.com/api/',
  timeout: 1000,
  headers: {'X-Custom-Header': 'foobar'}
});

Métodos de instancia

A continuación se muestran los métodos de instancia disponibles. La configuración especificada se fusionará con la configuración de la instancia:

axios#request(config)
axios#get(url[, config])
axios#delete(url[, config])
axios#head(url[, config])
axios#post(url[, data[, config]])
axios#put(url[, data[, config]])
axios#patch(url[, data[, config]])

Opciones de configuración de la solicitud

Las siguientes son las opciones de configuración disponibles al crear una solicitud. Ten en cuenta que solo url es obligatoria. Si no se especifica method, la solicitud utilizará el método get por defecto.

{
  // `url` 是用于请求的服务器 URL
  url: "/user",

  // `method` 是创建请求时使用的方法
  method: "get", // 默认是 get

  // `baseURL` 将自动加在 `url` 前面，除非 `url` 是一个绝对 URL.
  // 它可以通过设置一个 `baseURL` 便于为 axios 实例的方法传递相对 URL
  baseURL: "https://some-domain.com/api/",

  // `transformRequest` 允许在向服务器发送前，修改请求数据
  // 只能用在 "PUT", "POST" 和 "PATCH" 这几个请求方法
  // 后面数组中的函数必须返回一个字符串，或 ArrayBuffer，或 Stream
  transformRequest: [function (data) {
    // 对 data 进行任意转换处理

    return data;
  }],

  // `transformResponse` 在传递给 then/catch 前，允许修改响应数据
  transformResponse: [function (data) {
    // 对 data 进行任意转换处理

    return data;
  }],

  // `headers` 是即将被发送的自定义请求头
  headers: {"X-Requested-With": "XMLHttpRequest"},

  // `params` 是即将与请求一起发送的 URL 参数
  // 必须是一个无格式对象(plain object)或 URLSearchParams 对象
  params: {
    ID: 12345
  },

  // `paramsSerializer` 是一个负责 `params` 序列化的函数
  // (e.g. https://www.npmjs.com/package/qs, http://api.jquery.com/jquery.param/)
  paramsSerializer: function(params) {
    return Qs.stringify(params, {arrayFormat: "brackets"})
  },

  // `data` 是作为请求主体被发送的数据
  // 只适用于这些请求方法 "PUT", "POST", 和 "PATCH"
  // 在没有设置 `transformRequest` 时，必须是以下类型之一：
  // - string, plain object, ArrayBuffer, ArrayBufferView, URLSearchParams
  // - 浏览器专属：FormData, File, Blob
  // - Node 专属： Stream
  data: {
    firstName: "Fred"
  },

  // `timeout` 指定请求超时的毫秒数(0 表示无超时时间)
  // 如果请求花费了超过 `timeout` 的时间，请求将被中断
  timeout: 1000,

  // `withCredentials` 表示跨域请求时是否需要使用凭证
  withCredentials: false, // 默认的

  // `adapter` 允许自定义处理请求，以使测试更轻松
  // 返回一个 promise 并应用一个有效的响应 (查阅 [response docs](#response-api)).
  adapter: function (config) {
    /* ... */
  },

  // `auth` 表示应该使用 HTTP 基础验证，并提供凭据
  // 这将设置一个 `Authorization` 头，覆写掉现有的任意使用 `headers` 设置的自定义 `Authorization`头
  auth: {
    username: "janedoe",
    password: "s00pers3cret"
  },

  // `responseType` 表示服务器响应的数据类型，可以是 "arraybuffer", "blob", "document", "json", "text", "stream"
  responseType: "json", // 默认的

  // `xsrfCookieName` 是用作 xsrf token 的值的cookie的名称
  xsrfCookieName: "XSRF-TOKEN", // default

  // `xsrfHeaderName` 是承载 xsrf token 的值的 HTTP 头的名称
  xsrfHeaderName: "X-XSRF-TOKEN", // 默认的

  // `onUploadProgress` 允许为上传处理进度事件
  onUploadProgress: function (progressEvent) {
    // 对原生进度事件的处理
  },

  // `onDownloadProgress` 允许为下载处理进度事件
  onDownloadProgress: function (progressEvent) {
    // 对原生进度事件的处理
  },

  // `maxContentLength` 定义允许的响应内容的最大尺寸
  maxContentLength: 2000,

  // `validateStatus` 定义对于给定的HTTP 响应状态码是 resolve o  reject  promise 。如果 `validateStatus` 返回 `true` (或者设置为 `null` o  `undefined`)，promise 将被 resolve; 否则，promise 将被 rejecte
  validateStatus: function (status) {
    return status &gt;= 200 &amp;&amp; status &lt; 300; // 默认的
  },

  // `maxRedirects` 定义在 node.js 中 follow 的最大重定向数目
  // 如果设置为0，将不会 follow 任何重定向
  maxRedirects: 5, // 默认的

  // `httpAgent` 和 `httpsAgent` 分别在 node.js 中用于定义在执行 http 和 https 时使用的自定义代理。允许像这样配置选项：
  // `keepAlive` 默认没有启用
  httpAgent: new http.Agent({ keepAlive: true }),
  httpsAgent: new https.Agent({ keepAlive: true }),

  // "proxy" 定义代理服务器的主机名称和端口
  // `auth` 表示 HTTP 基础验证应当用于连接代理，并提供凭据
  // 这将会设置一个 `Proxy-Authorization` 头，覆写掉已有的通过使用 `header` 设置的自定义 `Proxy-Authorization` 头。
  proxy: {
    host: "127.0.0.1",
    port: 9000,
    auth: : {
      username: "mikeymike",
      password: "rapunz3l"
    }
  },

  // `cancelToken` 指定用于取消请求的 cancel token
  // （查看后面的 Cancellation 这节了解更多）
  cancelToken: new CancelToken(function (cancel) {
  })
}

Estructura de la respuesta

La respuesta de una solicitud de axios contiene la siguiente información:

{
  // `data` 由服务器提供的响应
  data: {},

  // `status`  HTTP 状态码
  status: 200,

  // `statusText` 来自服务器响应的 HTTP 状态信息
  statusText: "OK",

  // `headers` 服务器响应的头
  headers: {},

  // `config` 是为请求提供的配置信息
  config: {}
}

Al usar then, se recibe la siguiente respuesta:

axios.get("/user/12345")
  .then(function(response) {
    console.log(response.data);
    console.log(response.status);
    console.log(response.statusText);
    console.log(response.headers);
    console.log(response.config);
  });

Al usarcatch, o al pasarrejection callbackcomothensegundo parámetro, la respuesta puedeerrorusarse mediante el objeto.

Valores predeterminados de la configuración

Puedes especificar valores de configuración predeterminados que se usarán en cada solicitud.

Valores predeterminados globales de axios:

axios.defaults.baseURL = 'https://api.example.com';
axios.defaults.headers.common['Authorization'] = AUTH_TOKEN;
axios.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded';

Valores predeterminados de una instancia personalizada:

// 创建实例时设置配置的默认值
var instance = axios.create({
  baseURL: 'https://api.example.com'
});

// 在实例已创建后修改默认值
instance.defaults.headers.common['Authorization'] = AUTH_TOKEN;

Orden de prioridad de la configuración

La configuración se fusiona en un orden de prioridad. Este orden es: los valores predeterminados de la biblioteca que se encuentran en lib/defaults.js, luego la propiedad defaults de la instancia y finalmente el parámetro config de la solicitud. Este último tendrá prioridad sobre los anteriores. Aquí hay un ejemplo:

// 使用由库提供的配置的默认值来创建实例
// 此时超时配置的默认值是 `0`
var instance = axios.create();

// 覆写库的超时默认值
// 现在，在超时前，所有请求都会等待 2.5 秒
instance.defaults.timeout = 2500;

// 为已知需要花费很长时间的请求覆写超时设置
instance.get('/longRequest', {
  timeout: 5000
});

Interceptores

Intercepta las solicitudes o respuestas antes de que sean manejadas por then o catch.

// 添加请求拦截器
axios.interceptors.request.use(function (config) {
    // 在发送请求之前做些什么
    return config;
  }, function (error) {
    // 对请求错误做些什么
    return Promise.reject(error);
  });

// 添加响应拦截器
axios.interceptors.response.use(function (response) {
    // 对响应数据做点什么
    return response;
  }, function (error) {
    // 对响应错误做点什么
    return Promise.reject(error);
  });

Si deseas eliminar los interceptores más tarde, puedes hacerlo de la siguiente manera:

var myInterceptor = axios.interceptors.request.use(function () {/*...*/});
axios.interceptors.request.eject(myInterceptor);

Puedes agregar interceptores a una instancia de axios personalizada.

var instance = axios.create();
instance.interceptors.request.use(function () {/*...*/});

Manejo de errores:

axios.get('/user/12345')
  .catch(function (error) {
    if (error.response) {
      // 请求已发出，但服务器响应的状态码不在 2xx 范围内
      console.log(error.response.data);
      console.log(error.response.status);
      console.log(error.response.headers);
    } else {
      // Something happened in setting up the request that triggered an Error
      console.log('Error', error.message);
    }
    console.log(error.config);
  });

Puedes utilizar la opción de configuración validateStatus para definir un rango de errores personalizado para los códigos de estado HTTP.

axios.get('/user/12345', {
  validateStatus: function (status) {
    return status < 500; // 状态码在大于或等于500时才会 reject
  }
})

Cancelación

Cancela solicitudes usando cancel token.

La API de cancel token de Axios se basa encancelable promises proposal

Puedes crear un cancel token usando el método de fábrica CancelToken.source, así:

var CancelToken = axios.CancelToken;
var source = CancelToken.source();

axios.get('/user/12345', {
  cancelToken: source.token
}).catch(function(thrown) {
  if (axios.isCancel(thrown)) {
    console.log('Request canceled', thrown.message);
  } else {
    // 处理错误
  }
});

// 取消请求（message 参数是可选的）
source.cancel('Operation canceled by the user.');

También puedes crear un cancel token pasando una función executor al constructor de CancelToken:

var CancelToken = axios.CancelToken;
var cancel;

axios.get('/user/12345', {
  cancelToken: new CancelToken(function executor(c) {
    // executor 函数接收一个 cancel 函数作为参数
    cancel = c;
  })
});

// 取消请求
cancel();

Nota: Puedes usar el mismo cancel token para cancelar varias solicitudes.

Usar application/x-www-form-urlencoded en las solicitudes

Axios serializa por defecto los objetos de JavaScript como JSON. Si deseas usar el formato application/x-www-form-urlencoded, puedes usar la siguiente configuración.

Navegador

En el entorno del navegador, puedes usar la API URLSearchParams:

const params = new URLSearchParams();
params.append('param1', 'value1');
params.append('param2', 'value2');
axios.post('/foo', params);

URLSearchParams no es compatible con todos los navegadores.

Además, puedes usar la librería qs para codificar los datos:

const qs = require('qs');
axios.post('/foo', qs.stringify({ 'bar': 123 }));

// Or in another way (ES6),

import qs from 'qs';
const data = { 'bar': 123 };
const options = {
  method: 'POST',
  headers: { 'content-type': 'application/x-www-form-urlencoded' },
  data: qs.stringify(data),
  url,
};
axios(options);

Entorno Node.js

En Node.js, puedes usar el módulo querystring:

const querystring = require('querystring');
axios.post('http://something.com/', querystring.stringify({ foo: 'bar' }));

Por supuesto, al igual que en el navegador, también puedes usar la librería qs.

Promises

Axios depende de la implementación nativa de Promise de ES6 yes compatible.。

Si tu entorno no soporta Promise de ES6, puedes usarpolyfill。

Soporte de TypeScript

axios incluye las definiciones de TypeScript.

import axios from "axios";
axios.get("/user?ID=12345");

Otras extensiones

Manual de referencia

Caso práctico 1

Caso práctico 2

Vue3 Ajax(axios)

Método de instalación

Método de uso

Ejemplo

Ejemplo

Ejemplo

Ejemplo

Ejemplo

Compatibilidad con navegadores

Método GET

Ejemplo GET

Ejemplo GET

Descripción de los parámetros

Método POST

Ejemplo POST

Descripción de los parámetros

Realizar múltiples solicitudes concurrentes

Ejemplo

axios API

Ejemplo

Alias de los métodos de solicitud

Concurrencia

Crear una instancia

Métodos de instancia

Opciones de configuración de la solicitud

Estructura de la respuesta

Valores predeterminados de la configuración

Orden de prioridad de la configuración

Interceptores

Cancelación

Usar application/x-www-form-urlencoded en las solicitudes

Entorno Node.js

Promises

Soporte de TypeScript