es-toolkit compat 中的 trimEndLodash 兼容的尾部字符串裁剪函数详解【免费下载链接】es-toolkitA modern JavaScript utility library thats 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/compat中的trimEnd函数展开说明它与原生工具版trimEnd的差异、参数约定、底层实现原理以及为何推荐优先使用现代版本。读完本文你将掌握trimEnd在两类 API 下的完整用法、边界行为与源码级实现依据可直接在项目中正确选型与使用。重要提示本文讲解的是 es-toolkit 的 Lodash 兼容入口es-toolkit/compat中的trimEnd见 src/compat/string/trimEnd.ts。该函数因需要兼容 Lodash 的null/undefined处理与参数顺序约定运行速度较慢。官方明确建议使用更快的现代版本 es-toolkit/string 下的 trimEnd实现见 src/string/trimEnd.ts。功能概述trimEnd用于从字符串尾部移除空白字符或指定的字符集合const trimmed trimEnd(str, chars);它只作用于字符串末尾不会触碰开头与中间部分。无论传入的参数是否合法它始终返回一个新字符串不修改原字符串。兼容层用法trimEnd(str, chars)从 src/compat/string/trimEnd.ts 的源码可以看到该函数是针对 Lodash 行为做的兼容封装。使用时从es-toolkit/compat导入import { trimEnd } from es-toolkit/compat; // 移除尾部空白 trimEnd( abc ); // Returns: abc // 移除指定字符注意这里是字符集合而非单个字符串 trimEnd(-_-abc-_-, _-); // Returns: -_-abc // 只作用于字符串末尾 trimEnd(abc, a); // Returns: abc三个例子的要点未指定chars时仅移除尾部空白字符前导空格保留 abc。指定chars: _-时字符串末尾所有属于_或-的字符都会被逐个移除直到遇到不属于该集合的字符为止因此-_-abc-_-变为-_-abc。当目标字符只出现在开头而非末尾时trimEnd不做任何裁剪abc以a开头末尾是c保持不变。对null/undefined的处理兼容版遵循 Lodash 约定将null或undefined视为空字符串import { trimEnd } from es-toolkit/compat; trimEnd(null); // trimEnd(undefined); // 这一行为在源码中体现为入口处的空值短路if (str null) { return ; }对应测试见 src/compat/string/trimEnd.spec.ts也验证了trimEnd(null, chars)、trimEnd(undefined, chars)、trimEnd(, chars)全部返回空字符串。参数strstring可选要裁剪尾部的字符串。charsstring可选要移除的字符集合。不指定时移除空白字符。返回值string返回从末尾移除指定字符后的新字符串。兼容版底层实现剖析兼容版trimEnd的实现非常精简核心逻辑只有几条分支见 src/compat/string/trimEnd.tsexport function trimEnd(str?: string, chars?: string | number, guard?: object): string { if (str null) { return ; } if (guard ! null || chars null) { return str.toString().trimEnd(); } return trimEndToolkit(str, chars.toString().split()); }从中可以拆解出三个关键设计点guard参数作为 iteratee 使用。Lodash 的许多方法如_.map、_.filter会把(value, index, collection)作为参数传给回调。若直接传trimEnd给_.map第三位参数collection会被误认为是guard。源码中guard ! null时走str.toString().trimEnd()分支从而忽略后两个参数、只做空白裁剪。测试用例trimEndshould work as an iteratee for methods like_.map见 src/compat/string/trimEnd.spec.ts专门验证了这一点。类型强制转换coercion。str null之外的值会被str.toString()转成字符串chars则通过chars.toString().split()展开成字符数组。测试中传入带toString方法的普通对象也能正确工作见 src/compat/string/trimEnd.spec.ts。底层委托给工具版实现。裁剪逻辑本身复用了es-toolkit/string的trimEnd将chars拆分为字符数组后传入。这正是兼容版性能开销的来源它需要在每次调用时处理空值判断、参数顺序与类型转换再转交工具版执行。空白字符集合兼容版未指定chars时走原生String.prototype.trimEnd()其移除的空白集合由 ECMAScript 规范定义。仓库在测试中使用了自定义的whitespace常量来覆盖这些字符见 src/compat/_internal/whitespace.ts包括普通空格 、制表符\t、垂直制表符\x0b、换页符\f换行\n、回车\r、不换行空格\xa0、零宽不换行空格\ufeffUnicode 行分隔符\u2028、段分隔符\u2029各种 Unicode 空格\u1680、\u180e、\u2000–\u200a、\u202f、\u205f、\u3000等。该常量通过/\s/.exec(chr)过滤只保留正则\s认可的字符。测试用例trimEndshould remove trailing whitespace见 src/compat/string/trimEnd.spec.ts用${whitespace}a b c${whitespace}验证了这些字符会被统一裁剪。与 es-toolkit 现代版 trimEnd 的对比官方推荐使用 es-toolkit/string 下的 trimEnd它的 API 与行为更现代、性能更好import { trimEnd } from es-toolkit/string; // 基础空白裁剪 trimEnd(hello ); // hello trimEnd(hello\t\n ); // hello // 移除指定字符 trimEnd(hello---, -); // hello trimEnd(123000, 0); // 123 trimEnd(abcabcabc, c); // abcabcab // 以数组形式指定多个字符 trimEnd(hello!!, [!, ]); // hello trimEnd(abc123, [1, 2, 3]); // abc trimEnd(hello__ , [_, ]); // hello两者的核心差异均有源码依据维度兼容版es-toolkit/compat现代版es-toolkit/string导入入口es-toolkit/compates-toolkit/stringchars类型string \| number内部拆分为字符数组string \| string[]多字符指定方式字符串按字符集合处理如_-表示_或-字符串必须为单个字符多字符用数组null/undefined视为空字符串返回类型上要求string不处理空值iteratee 兼容guard支持可安全传给_.map不支持额外开销空值判断、参数顺序适配、类型转换无字符串长度校验无按集合处理chars为长度 ≠ 1 的字符串时抛错现代版在实现上见 src/string/trimEnd.ts会先检查chars类型undefined时直接调用str.trimEnd()字符串长度不等于 1 时抛出Error(The chars parameter should be a single character string.)字符串或字符数组分支则从尾部逐字符向前扫描直到遇到不属于目标集合的字符为止。由于它不做兼容层的空值与类型适配执行路径更短这正是官方文档标注其“更快”的原因。选型建议新代码优先使用import { trimEnd } from es-toolkit/string更快的原生裁剪路径、更严格的参数约束能尽早暴露误用如传入多字符字符串。迁移 Lodash 存量代码时使用import { trimEnd } from es-toolkit/compat它完整保留了 Lodash 的行为——null/undefined返回空串、chars按字符集合处理、可作为_.map等方法的 iteratee 直接使用让迁移过程无需改动调用点。若需要在现代版中裁剪多个字符请显式使用数组形式trimEnd(hello!!, [!, ])避免触发抛错。两种实现都可以在仓库中找到完整源码与测试佐证兼容版源码 与 兼容版测试、现代版源码 与对应 API 文档便于进一步研读与验证。【免费下载链接】es-toolkitA modern JavaScript utility library thats 2-3 times faster and up to 97% smaller, a major upgrade to lodash.项目地址: https://gitcode.com/GitHub_Trending/es/es-toolkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 es-toolkit compat 中的 trimEnd：Lodash 兼容的尾部字符串裁剪函数详解
es-toolkit compat 中的 trimEndLodash 兼容的尾部字符串裁剪函数详解【免费下载链接】es-toolkitA modern JavaScript utility library thats 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/compat中的trimEnd函数展开说明它与原生工具版trimEnd的差异、参数约定、底层实现原理以及为何推荐优先使用现代版本。读完本文你将掌握trimEnd在两类 API 下的完整用法、边界行为与源码级实现依据可直接在项目中正确选型与使用。重要提示本文讲解的是 es-toolkit 的 Lodash 兼容入口es-toolkit/compat中的trimEnd见 src/compat/string/trimEnd.ts。该函数因需要兼容 Lodash 的null/undefined处理与参数顺序约定运行速度较慢。官方明确建议使用更快的现代版本 es-toolkit/string 下的 trimEnd实现见 src/string/trimEnd.ts。功能概述trimEnd用于从字符串尾部移除空白字符或指定的字符集合const trimmed trimEnd(str, chars);它只作用于字符串末尾不会触碰开头与中间部分。无论传入的参数是否合法它始终返回一个新字符串不修改原字符串。兼容层用法trimEnd(str, chars)从 src/compat/string/trimEnd.ts 的源码可以看到该函数是针对 Lodash 行为做的兼容封装。使用时从es-toolkit/compat导入import { trimEnd } from es-toolkit/compat; // 移除尾部空白 trimEnd( abc ); // Returns: abc // 移除指定字符注意这里是字符集合而非单个字符串 trimEnd(-_-abc-_-, _-); // Returns: -_-abc // 只作用于字符串末尾 trimEnd(abc, a); // Returns: abc三个例子的要点未指定chars时仅移除尾部空白字符前导空格保留 abc。指定chars: _-时字符串末尾所有属于_或-的字符都会被逐个移除直到遇到不属于该集合的字符为止因此-_-abc-_-变为-_-abc。当目标字符只出现在开头而非末尾时trimEnd不做任何裁剪abc以a开头末尾是c保持不变。对null/undefined的处理兼容版遵循 Lodash 约定将null或undefined视为空字符串import { trimEnd } from es-toolkit/compat; trimEnd(null); // trimEnd(undefined); // 这一行为在源码中体现为入口处的空值短路if (str null) { return ; }对应测试见 src/compat/string/trimEnd.spec.ts也验证了trimEnd(null, chars)、trimEnd(undefined, chars)、trimEnd(, chars)全部返回空字符串。参数strstring可选要裁剪尾部的字符串。charsstring可选要移除的字符集合。不指定时移除空白字符。返回值string返回从末尾移除指定字符后的新字符串。兼容版底层实现剖析兼容版trimEnd的实现非常精简核心逻辑只有几条分支见 src/compat/string/trimEnd.tsexport function trimEnd(str?: string, chars?: string | number, guard?: object): string { if (str null) { return ; } if (guard ! null || chars null) { return str.toString().trimEnd(); } return trimEndToolkit(str, chars.toString().split()); }从中可以拆解出三个关键设计点guard参数作为 iteratee 使用。Lodash 的许多方法如_.map、_.filter会把(value, index, collection)作为参数传给回调。若直接传trimEnd给_.map第三位参数collection会被误认为是guard。源码中guard ! null时走str.toString().trimEnd()分支从而忽略后两个参数、只做空白裁剪。测试用例trimEndshould work as an iteratee for methods like_.map见 src/compat/string/trimEnd.spec.ts专门验证了这一点。类型强制转换coercion。str null之外的值会被str.toString()转成字符串chars则通过chars.toString().split()展开成字符数组。测试中传入带toString方法的普通对象也能正确工作见 src/compat/string/trimEnd.spec.ts。底层委托给工具版实现。裁剪逻辑本身复用了es-toolkit/string的trimEnd将chars拆分为字符数组后传入。这正是兼容版性能开销的来源它需要在每次调用时处理空值判断、参数顺序与类型转换再转交工具版执行。空白字符集合兼容版未指定chars时走原生String.prototype.trimEnd()其移除的空白集合由 ECMAScript 规范定义。仓库在测试中使用了自定义的whitespace常量来覆盖这些字符见 src/compat/_internal/whitespace.ts包括普通空格 、制表符\t、垂直制表符\x0b、换页符\f换行\n、回车\r、不换行空格\xa0、零宽不换行空格\ufeffUnicode 行分隔符\u2028、段分隔符\u2029各种 Unicode 空格\u1680、\u180e、\u2000–\u200a、\u202f、\u205f、\u3000等。该常量通过/\s/.exec(chr)过滤只保留正则\s认可的字符。测试用例trimEndshould remove trailing whitespace见 src/compat/string/trimEnd.spec.ts用${whitespace}a b c${whitespace}验证了这些字符会被统一裁剪。与 es-toolkit 现代版 trimEnd 的对比官方推荐使用 es-toolkit/string 下的 trimEnd它的 API 与行为更现代、性能更好import { trimEnd } from es-toolkit/string; // 基础空白裁剪 trimEnd(hello ); // hello trimEnd(hello\t\n ); // hello // 移除指定字符 trimEnd(hello---, -); // hello trimEnd(123000, 0); // 123 trimEnd(abcabcabc, c); // abcabcab // 以数组形式指定多个字符 trimEnd(hello!!, [!, ]); // hello trimEnd(abc123, [1, 2, 3]); // abc trimEnd(hello__ , [_, ]); // hello两者的核心差异均有源码依据维度兼容版es-toolkit/compat现代版es-toolkit/string导入入口es-toolkit/compates-toolkit/stringchars类型string \| number内部拆分为字符数组string \| string[]多字符指定方式字符串按字符集合处理如_-表示_或-字符串必须为单个字符多字符用数组null/undefined视为空字符串返回类型上要求string不处理空值iteratee 兼容guard支持可安全传给_.map不支持额外开销空值判断、参数顺序适配、类型转换无字符串长度校验无按集合处理chars为长度 ≠ 1 的字符串时抛错现代版在实现上见 src/string/trimEnd.ts会先检查chars类型undefined时直接调用str.trimEnd()字符串长度不等于 1 时抛出Error(The chars parameter should be a single character string.)字符串或字符数组分支则从尾部逐字符向前扫描直到遇到不属于目标集合的字符为止。由于它不做兼容层的空值与类型适配执行路径更短这正是官方文档标注其“更快”的原因。选型建议新代码优先使用import { trimEnd } from es-toolkit/string更快的原生裁剪路径、更严格的参数约束能尽早暴露误用如传入多字符字符串。迁移 Lodash 存量代码时使用import { trimEnd } from es-toolkit/compat它完整保留了 Lodash 的行为——null/undefined返回空串、chars按字符集合处理、可作为_.map等方法的 iteratee 直接使用让迁移过程无需改动调用点。若需要在现代版中裁剪多个字符请显式使用数组形式trimEnd(hello!!, [!, ])避免触发抛错。两种实现都可以在仓库中找到完整源码与测试佐证兼容版源码 与 兼容版测试、现代版源码 与对应 API 文档便于进一步研读与验证。【免费下载链接】es-toolkitA modern JavaScript utility library thats 2-3 times faster and up to 97% smaller, a major upgrade to lodash.项目地址: https://gitcode.com/GitHub_Trending/es/es-toolkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考