企业官网建设流程全解析

es-toolkit/fp 函数式编程指南：掌握 tail() 管道化去首元素变换

【免费下载链接】es-toolkitA modern JavaScript utility library that's 2-3 times faster and up to 97% smaller, a major upgrade to lodash.项目地址: https://gitcode.com/GitHub_Trending/es/es-toolkit

在 es-toolkit 的函数式编程子模块es-toolkit/fp中，tail()并不是一个直接处理数组的函数，而是一个函数工厂：调用tail()会返回一个「接收数组、返回去掉第一个元素后的新数组」的变换函数，专门用于嵌入pipe管道中完成从左到右的数据流变换。本文以docs/ja/fp/reference/tail.md为核心，结合仓库源码与测试用例，完整讲解fp版tail的用法、与普通tail的区别、底层实现原理及典型实战场景。读完本文，你将能在管道式编程中熟练运用tail()处理栈、队列等需要跳过首个元素的数据流。

核心概念：fp版tail是一个函数工厂

与普通的tail(arr)直接返回数组不同，fp版的tail采用柯里化风格设计：

const result = pipe(array, tail());

tail()不接受任何参数，直接以tail()形式调用，返回一个类型为(array: readonly T[]) => T[]的函数。该函数接收一个readonly T[]，并返回去掉第一个元素后的新数组。这正是函数式编程中典型的「数据最后传入」设计：把数组操作的数据参数后置，从而让变换函数可以被自由组合进管道。

基本用法

tail()会从被管道传入的数组中移除第一个值，返回剩余元素组成的新数组：

import { pipe, tail } from 'es-toolkit/fp'; pipe([1, 2, 3], tail()); // => [2, 3]

从调用方式可以看到，数据[1, 2, 3]作为pipe的初始值传入，tail()返回的变换函数随后被应用到该数组上，最终得到[2, 3]。整个变换顺序与代码阅读顺序一致，自上而下，避免了嵌套函数调用带来的可读性问题。

参数

tail()不接收任何参数，必须写成tail()的形式——注意括号不可省略，因为你需要的是它返回的变换函数，而不是函数本身。

返回值

返回类型为(array: readonly T[]) => T[]：一个把readonly T[]映射为「去掉第一个元素后的数组」的函数。输入为readonly T[]意味着它同样适用于只读数组或元组类型。

何时使用fp版，何时使用普通tail

fp版tail与普通版tail功能等价，但适用场景不同，官方文档给出了明确建议：

• 普通代码中（即不组合管道时），推荐使用 es-toolkit 原始的tail，直接调用tail(arr)即可；
• 使用pipe串联多个变换时，应使用fp版tail()，因为它返回的函数可以直接嵌入管道。

两种用法的对比：

// 普通写法：直接传入数组 import { tail } from 'es-toolkit/array'; tail([1, 2, 3]); // => [2, 3] // fp 写法：tail() 返回变换函数，供 pipe 使用 import { pipe, tail } from 'es-toolkit/fp'; pipe([1, 2, 3], tail()); // => [2, 3]

底层实现：从fp到核心数组函数的委托

查看fp版tail的源码src/fp/array/tail.ts，其实现非常简洁——它只是把核心的数组tail函数包装成了一个延迟接收数组的闭包：

export function tail<T>(): (array: readonly T[]) => T[] { return function (array: readonly T[]): T[] { return tailToolkit(array); }; }

其中tailToolkit从src/array/tail.ts导入。可以看到fp层并不重复实现算法，而是通过闭包捕获的方式，把「在调用tail()时确定变换逻辑、在管道执行时才接收具体数据」这一流程解耦开来，这正是es-toolkit/fp所有函数共用的设计模式。

真正完成去首操作的逻辑在src/array/tail.ts的最终实现：

export function tail<T>(arr: readonly T[]): T[] { return arr.slice(1); }

底层仅依赖原生Array.prototype.slice(1)，因此fp版tail继承了核心版的所有边界行为：

• 空数组输入返回空数组[]；
• 单元素数组输入返回空数组[]；
• 嵌套数组、对象数组等任意元素类型均可正确处理（元素本身不会被浅拷贝修改，只是被原样保留在新数组中）；
• 返回的是新数组，不会修改原数组。

在pipe中组合使用

pipe是es-toolkit/fp的合成入口（见docs/ja/fp/reference/pipe.md）：它接收一个初始值，然后从左到右依次应用一系列函数，前一个函数的输出作为后一个函数的输入。tail()非常适合作为管道中的「去首」环节，例如先去除数组第一个元素，再继续做其他变换：

import { pipe, tail, map } from 'es-toolkit/fp'; // 去掉第一个元素后，将剩余元素翻倍 pipe( [1, 2, 3, 4], tail(), map(x => x * 2) ); // => [4, 6, 8]

在栈或队列场景中，tail()尤其实用：当你需要处理「除队首/栈顶之外的其余元素」时，可以将其作为管道的起始变换。任意单参函数（包括自定义函数）都可以与tail()一同放在pipe中，例如：

import { pipe, tail } from 'es-toolkit/fp'; pipe( ['header', 'row1', 'row2'], tail(), rows => rows.join(', ') ); // => 'row1, row2'

测试验证：pipe中的正确性保证

仓库为fp版tail提供了专门的测试src/fp/array/tail.spec.ts：

import { describe, expect, it } from 'vitest'; import { tail } from './tail.ts'; import { pipe } from '../pipe.ts'; describe('tail', () => { it('works in a pipe', () => { expect(pipe([1, 2, 3], tail())).toEqual([2, 3]); }); });

该测试直接验证了pipe([1, 2, 3], tail())的结果为[2, 3]，从侧面确认了「tail()返回的变换函数可以被pipe正确串联」这一核心契约。而核心版tail的测试src/array/tail.spec.ts则覆盖了边界情况：数字数组、布尔数组、单元素数组、空数组，全部返回符合预期的结果。

此外，tail已通过src/fp/array/index.ts统一导出，与head、initial、last、take等数组函数并列，可以从es-toolkit/fp顶层入口直接导入。

类型层面的细节

fp版tail的泛型签名tail<T>(): (array: readonly T[]) => T[]表明：

• 泛型T在调用tail()时即可被推断，返回的变换函数会保持元素类型一致；
• 入参接受readonly T[]，兼容ReadonlyArray与元组场景；
• 出参为可变数组T[]，方便后续变换继续处理。

结合核心版src/array/tail.ts中为空数组、单元素元组、元组类型分别提供的多个重载实现，TypeScript 用户可以在严格类型检查下获得精确的返回值类型推导，例如对[1, 2, 3]这样的元组调用后能直接推导出number[]。

小结

es-toolkit/fp的tail()以「零参数函数工厂 + 数据后置」的函数式设计，让「去首元素」这一基础数组操作可以无缝嵌入pipe管道。它的底层实现是对核心版tail（即arr.slice(1)）的轻量封装，因此在保留全部边界行为（空数组、单元素数组返回[]、不修改原数组）的同时，获得了管道组合能力。在需要跳过首个元素的栈、队列处理以及多步数据变换流程中，pipe(array, tail(), ...)是最简洁直接的写法；而在非管道化的普通代码里，直接使用es-toolkit/array的tail即可。

【免费下载链接】es-toolkitA modern JavaScript utility library that's 2-3 times faster and up to 97% smaller, a major upgrade to lodash.项目地址: https://gitcode.com/GitHub_Trending/es/es-toolkit