jQuery 中 param() 方法的用途是什么？

简介

在使用 jQuery 时，我们经常需要将 JavaScript 对象转换为可用于 HTTP 请求的字符串。jQuery 中的 param() 方法就是用于将 JavaScript 对象转换为字符串的工具函数。

用法

$.param(obj)

param() 方法接收一个 JavaScript 对象作为参数，返回一个包含其属性和值的字符串，以用于构建 HTTP 请求参数。例如，下面这个对象：

var obj = { name: 'John', age: 26 };

使用 param() 方法转换为字符串后，将得到：

"name=John&age=26"

注意，生成的字符串中，每个属性和值都用等号连接，而不是冒号。不同的属性值之间用 & 连接。

嵌套对象

如果对象的属性值也是对象，那么将会递归生成字符串，直到所有对象都转换为字符串。例如，下面这个对象：

var obj = { name: 'John', address: { city: 'New York', state: 'NY' } };

使用 param() 方法转换为字符串后，将得到：

"name=John&address[city]=New%20York&address[state]=NY"

可以看到，在返回的字符串中，地址属性的值是嵌套对象，它们通过方括号 [] 表示。同时，字符串中的空格也被编码成了 %20。

数组

如果对象的属性值是数组，那么每个数组元素都将作为一个独立的属性转换为字符串。例如，下面这个对象：

var obj = { name: 'John', interests: ['music', 'movies', 'sports'] };

使用 param() 方法转换为字符串后，将得到：

"name=John&interests[]=music&interests[]=movies&interests[]=sports"

可以看到，在返回的字符串中，兴趣属性的值是一个数组，它们通过方括号 [] 表示，每个数组元素都在后面加上了一个 [] 括号。

可选参数

param() 方法接收一个可选的布尔值作为第二个参数，表示是否编码生成的字符串。默认为 true，即需要编码。例如：

var obj = { name: 'John Smith', interests: ['music', 'movies', 'sports'] };
var str1 = $.param(obj);
// name=John%20Smith&interests[]=music&interests[]=movies&interests[]=sports

var str2 = $.param(obj, false);
// name=John Smith&interests[]=music&interests[]=movies&interests[]=sports

可以看到，在第二个例子中，生成的字符串中的空格没有被编码。

结论

param() 方法是一个非常实用的工具函数，特别适用于构建 HTTP 请求参数字符串。在处理对象、嵌套对象、数组等复杂数据结构时，它能够很好地转换并生成所需的字符串。需要注意的是，在默认情况下，它会对生成的字符串进行编码，如果不需要编码，则需要手动将可选参数设为 false。