VueUse中useFetch处理数组payload的注意事项

在使用VueUse的useFetch进行HTTP请求时，开发者可能会遇到一个常见但容易被忽视的问题：当发送数组作为请求体(payload)时，数据没有被正确序列化。本文将深入分析这个问题及其解决方案。

问题现象

当开发者尝试通过useFetch发送包含数组的payload时，在开发者工具的Network面板中会发现请求体显示为"[object Object]"，而不是预期的JSON格式数组。这表明数据在传输前没有被正确序列化。

问题原因

这个问题的根源在于useFetch的默认行为。默认情况下，useFetch会自动处理简单对象(Object)的序列化，但对于数组类型的payload，它不会自动执行JSON.stringify操作。这与开发者对现代HTTP客户端库的预期行为存在差异。

解决方案

VueUse提供了显式指定payload类型的方式来解决这个问题。开发者可以通过在post方法中传递第二个参数来明确指定payload的类型：

import { useFetch } from '@vueuse/core'
import { ref } from 'vue'

const form = ref([{test: true, working: false}])
const { execute } = useFetch('https://httpbin.org/post', { immediate: false })
  .post(form, 'json')
  .json()

function submit() {
  execute()
}

关键点在于.post(form, 'json')中的第二个参数'json'，它明确告诉useFetch需要对payload进行JSON序列化处理。

深入理解

1. 默认行为：useFetch对普通对象会自动序列化，但对数组不会
2. 类型参数：可用的类型包括'json'、'text'、'blob'等
3. 性能考量：显式指定类型可以避免不必要的序列化操作
4. 一致性：建议在项目中统一处理payload类型，避免不一致

最佳实践

1. 对于复杂数据结构，始终显式指定payload类型
2. 在团队项目中，建立统一的HTTP请求处理规范
3. 考虑封装自定义hook来统一处理序列化逻辑
4. 在TypeScript项目中，可以利用类型系统来确保payload类型安全

总结

VueUse的useFetch是一个强大且灵活的HTTP请求工具，但在处理数组payload时需要特别注意。通过理解其内部机制并采用显式指定类型的方式，开发者可以避免潜在的问题，构建更健壮的应用程序。记住，明确总是优于隐式，特别是在数据处理和网络通信这种关键环节。