什么是 obj-transmute？
obj-transmute 是一个用于在 JavaScript 对象之间进行转换的 npm 包，它可以帮助前端开发者更容易地进行数据格式转换，尤其是在处理 api 返回数据格式和页面展示的数据格式不一致的时候。
安装和使用
安装 obj-transmute 很简单，只需要在命令行中运行以下命令即可：
npm install obj-transmute
使用 obj-transmute 也十分简单。首先要引用它：
const objTransmute = require('obj-transmute');然后定义一份包含所有转换规则的转换配置，例如我们有以下的数据：
const rawData = {
name: 'Jack',
age: '18',
email: 'jack@example.com'
};我们想要将这份数据转换为如下的格式：
-- -------------------- ---- -------
----- --------------- - -
--------- -------
-------- -
---- ---
-------- -
------ ------------------
-
-
--我们可以这样设置转换配置：
const config = [
{ from: 'name', to: 'username' },
{ from: 'age', to: 'profile.age', type: 'number' },
{ from: 'email', to: 'profile.contact.email' }
];最后调用 obj-transmute 的 transmute 方法进行转换即可：
const result = objTransmute.transmute(rawData, config);
console.log(result);
// { username: 'Jack', profile: { age: 18, contact: { email: 'jack@example.com' } } }详解转换配置
在前面的例子中，我们使用了一个简单的转换配置，但实际上它可以支持更复杂的规则。
from 和 to
配置中最基本的两个属性是 from 和 to，它们用于描述被转换对象中的属性名称和转换后的属性名称。
举个例子，如果我们有如下的数据：
const data = {
name: 'Jack',
age: 18
};我们想要将它转换成如下的格式：
const transformedData = {
username: 'Jack',
userAge: 18
};那么转换配置是这样的：
const config = [
{ from: 'name', to: 'username' },
{ from: 'age', to: 'userAge' }
];type
除了基本的属性名转换外，obj-transmute 还可以进行类型转换。例如在前面的例子中，我们将 age 从字符串类型转换为了数字类型。这是通过在转换配置中添加 type 属性来实现的。
obj-transmute 支持的数据类型包括：
- string
- number
- boolean
- date
举个例子，如果我们有如下的数据：
const data = {
name: 'Jack',
birthdate: '2000-01-01'
};我们想要将它转换成如下的格式：
const transformedData = {
username: 'Jack',
age: 22
};我们首先需要对 birthdate 进行转换：
const config = [
{ from: 'name', to: 'username' },
{ from: 'birthdate', to: 'age', type: 'date', format: 'YYYY-MM-DD' }
];配置中的 format 属性告诉 obj-transmute 如何解析日期字符串。
defaultValue
有些情况下，被转换对象可能没有某个属性。此时如果直接进行转换将会导致错误。为了避免这种情况，我们可以使用 defaultValue 属性来设置默认值。
例如如果我们有如下的数据：
const data = {
name: 'Jack',
age: null
};我们想要将它转换成如下的格式：
const transformedData = {
username: 'Jack',
userAge: 0
};我们需要对 age 进行转换，并且设置一个默认值：
const config = [
{ from: 'name', to: 'username' },
{ from: 'age', to: 'userAge', type: 'number', defaultValue: 0 }
];condition
有些情况下，我们需要根据某个条件来判断是否进行属性转换。此时可以添加一个 condition 属性，它是一个函数，返回值为布尔类型。
例如如果我们有如下的数据：
const data = {
name: 'Jack',
age: 18,
isAdmin: true
};我们想要将它转换成如下的格式：
const transformedData = {
username: 'Jack'
};
if (data.isAdmin) {
transformedData.userAge = 18;
}我们需要添加一个条件判断：
const config = [
{ from: 'name', to: 'username' },
{ from: 'age', to: 'userAge', type: 'number', condition: data => data.isAdmin }
];总结
obj-transmute 是一个非常实用的 npm 包，它可以帮助前端开发者更容易地进行数据格式转换。通过转换配置的设置，我们可以对数据进行更为复杂的转换操作，包括属性名转换、类型转换、默认值设置和条件判断等。希望本文能够帮助读者更好地理解和使用 obj-transmute 这个库。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066f9c3d1de16d83a66f53