@antv/util

What is @antv/util?

@antv/util is a utility library that provides a collection of functions for common programming tasks. It is part of the AntV ecosystem, which is a suite of data visualization tools. The library includes functions for data manipulation, type checking, deep cloning, and more.

What are @antv/util's main functionalities?

Type Checking

The @antv/util package provides various type-checking functions to determine the type of a given value. In this example, `isString` is used to check if a value is a string.

const isString = require('@antv/util/lib/type/isString');
console.log(isString('Hello World')); // true
console.log(isString(123)); // false

Deep Clone

The `deepClone` function creates a deep copy of an object, ensuring that nested objects are also cloned. This is useful for creating independent copies of complex data structures.

const deepClone = require('@antv/util/lib/deepClone');
const obj = { a: 1, b: { c: 2 } };
const clonedObj = deepClone(obj);
console.log(clonedObj); // { a: 1, b: { c: 2 } }
console.log(clonedObj === obj); // false

Data Manipulation

The `groupBy` function allows you to group an array of objects by a specified key. This is useful for organizing data into categories or groups.

const groupBy = require('@antv/util/lib/array/groupBy');
const data = [
  { category: 'fruit', name: 'apple' },
  { category: 'fruit', name: 'banana' },
  { category: 'vegetable', name: 'carrot' }
];
const groupedData = groupBy(data, 'category');
console.log(groupedData); // { fruit: [{ category: 'fruit', name: 'apple' }, { category: 'fruit', name: 'banana' }], vegetable: [{ category: 'vegetable', name: 'carrot' }] }

Other packages similar to @antv/util

lodash

Lodash is a popular utility library that provides a wide range of functions for data manipulation, type checking, and more. It is widely used and has a large community. Compared to @antv/util, Lodash offers a more extensive set of utilities and is more commonly used in the JavaScript ecosystem.

underscore

Underscore is another utility library that offers a variety of functions for common programming tasks. It is similar to Lodash but has a smaller footprint. While @antv/util is part of the AntV ecosystem, Underscore is a standalone library that focuses solely on utility functions.

ramda

Ramda is a functional programming library for JavaScript that emphasizes immutability and side-effect-free functions. It provides a different approach compared to @antv/util, focusing on functional programming paradigms. Ramda is ideal for developers who prefer a functional style of coding.

README

util

AntV 底层依赖的工具库，不建议在自己业务中使用。

Usage

import { gradient } from '@antv/util';

原则

• util 只有一个 npm 包，按照目录来组织不同类型的方法，避免 monorepo 互相依赖
• 内容和 AntV 强相关，避免做和 lodash 等相同的工具库
• 不使用的方法，及时删除，并保持新增方法可以按需引入
• 旧版本的不维护，如果 AntV 技术栈的旧版本需要迭代，请升级到 v3

License

MIT@AntV.