使用 ES7 的 Map.prototype.toURL() 和 Map.prototype.fromURL() 实现 URL 和 Map 之间的转换

前言

在前端开发中，我们常常需要在不同的页面或组件之间进行数据传输，而 URL 参数则是其中一种常用的方式。我们可以通过将数据转换为 URL 参数的形式来方便地进行传输和解析。而在 JavaScript 中，Map 是一种常见的数据结构，它提供了比 Object 更加强大和灵活的键值对存储。本文将介绍 ES7 新增的 Map.prototype.toURL() 和 Map.prototype.fromURL() 方法，帮助我们更加方便地进行 URL 参数与 Map 之间的转换。

Map.prototype.toURL()

Map.prototype.toURL() 方法会将 Map 对象转换为 URL 参数的形式。它将返回一个字符串，包含了 Map 中所有的键值对。

const myMap = new Map();
myMap.set('name', 'Tom');
myMap.set('age', 18);
const urlParams = myMap.toURL();
console.log(urlParams); // "name=Tom&age=18"

Map.prototype.toURL() 方法接受一个可选参数 options，用于配置 URL 的格式。其中， options.encode 和 options.separator 分别表示编码函数和分隔符。

• options.encode：编码函数，默认为 encodeURIComponent。
• options.separator：分隔符，默认为 &。

const myMap = new Map();
myMap.set('name', 'Tom & Jerry');
myMap.set('age', 18);
const urlParams = myMap.toURL({
  encode: (value) => value.replace(/ /g, '+'),
  separator: ';',
});
console.log(urlParams); // "name=Tom+%26+Jerry;age=18"

在以上例子中，我们自定义了编码函数和分隔符。编码函数将空格替换为 +，分隔符则改为 ;。

Map.prototype.fromURL()

Map.prototype.fromURL() 方法将 URL 参数转换为 Map 对象。它接受一个字符串参数，返回一个 Map 对象。

const urlParams = 'name=Tom&age=18';
const myMap = new Map().fromURL(urlParams);
console.log(myMap); // { name: "Tom", age: "18" }

Map.prototype.fromURL() 方法同样接受一个可选参数 options，用于配置解析 URL 的方式。其中， options.decode 和 options.separator 分别表示解码函数和分隔符。

• options.decode：解码函数，默认为 decodeURIComponent。
• options.separator：分隔符，默认为 &。

const urlParams = 'name=Tom+%26+Jerry;age=18';
const myMap = new Map().fromURL(urlParams, {
  decode: (value) => value.replace(/\+/g, ' '),
  separator: ';',
});
console.log(myMap); // { name: "Tom & Jerry", age: "18" }

在以上例子中，我们自定义了解码函数和分隔符。解码函数将 + 替换为空格，分隔符则改为 ;。

使用示例

下面是一个完整的使用示例，展示如何使用 Map.prototype.toURL() 和 Map.prototype.fromURL() 方法在不同的页面或组件之间传递和解析数据。

<!-- 页面 1 -->
<a href="/page2.html?name=Tom&age=18">跳转到页面 2</a>

<!-- 页面 2 -->
<script>
  const urlParams = new URLSearchParams(window.location.search);
  const myMap = new Map().fromURL(urlParams.toString());

  console.log(myMap.get('name')); // "Tom"
  console.log(myMap.get('age')); // "18"

  const otherValue = 'otherValue';
  myMap.set('otherKey', otherValue);

  const newUrlParams = myMap.toURL();
  const newUrl = `${window.location.pathname}?${newUrlParams}`;
  window.history.replaceState(null, '', newUrl);
</script>

在以上示例中，我们在页面 1 中通过 URL 参数传递了一个 Map 对象，包含了 name 和 age 两个键值对。在页面 2 中，我们根据 URL 参数使用 Map.prototype.fromURL() 方法将数据解析成 Map 对象，并对其进行修改。随后，我们又使用 Map.prototype.toURL() 方法将修改后的 Map 对象转换为 URL 参数，以便于之后的传输和解析。

总结

ES7 的 Map.prototype.toURL() 和 Map.prototype.fromURL() 方法为前端开发中 URL 参数和 Map 对象之间的转换提供了更加方便和灵活的方式。使用这两个方法，我们可以避免手动拼接 URL 参数的繁琐工作，并且可以通过配置选项来适应不同的需求。在实际开发中，我们可以结合这些方法，方便地进行数据传输和解析，提升开发效率和数据交互的可靠性。

来源：JavaScript中文网 ，转载请注明来源 本文地址：https://www.javascriptcn.com/post/65a766e2add4f0e0ff074bf2