underscoreAPI文档（英文版pdf）

### Underscore.js API 文档概述 #### 一、引言 Underscore.js 是一个功能强大的 JavaScript 工具库，它提供了大量的函数式编程支持，这些支持在 Prototype.js 或 Ruby 中是常见的，但并未扩展任何内置的 JavaScript 对象。Underscore 的设计初衷是为了与 jQuery 和 Backbone.js 协同工作，作为它们的补充工具库。 #### 二、核心特点 - **无污染的全局命名空间**：与许多其他 JavaScript 库不同，Underscore.js 不会扩展任何内置对象，这确保了代码的纯净性。 - **丰富的功能集**：提供超过 80 秚实用函数，包括常见的函数式编程函数如 `map`, `select`, `invoke` 以及更专业化的助手函数如函数绑定、JavaScript 模板引擎、深度相等性测试等。 - **高性能**：对于现代浏览器中的原生方法（例如 `forEach`, `map`, `reduce`, `filter`, `every`, `some` 和 `indexOf`），Underscore 会委托给它们来提高性能。 #### 三、文档资源 - **GitHub 项目页面**：用户可以在 GitHub 上找到该项目的主页，可以报告 bug 并讨论新特性。 - **文档云**：可以在 Freenode 的 #documentcloud 频道中讨论相关问题，或者通过 Twitter 联系 @documentcloud。 - **源码注释**：Underscore 提供了详细的源码注释，方便开发者学习和理解其内部实现。 - **测试与基准套件**：包含了完整的测试和基准测试套件，以帮助开发者评估和调试。 #### 四、下载资源 - **开发版本**：未压缩并包含大量注释，适用于开发环境。 - **生产版本**：已压缩并 Gzip 压缩，适合部署到生产环境中。 - **边缘版本**：当前主分支的最新代码，可能存在未知风险。 #### 五、核心函数介绍 ##### 5.1 Collection Functions - **each/forEach** - **功能描述**：遍历一个列表（数组或对象）中的每个元素，并将每个元素传递给迭代器函数。 - **参数**： - `list`：要遍历的列表。 - `iterator`：每次迭代调用的函数。 - `context`：可选参数，用于设置迭代器函数的作用域。 - **示例**： ```javascript _.each([1, 2, 3], alert); // 分别弹出每个数字 _.each({one: 1, two: 2, three: 3}, alert); // 分别弹出每个值 ``` - **map/collect** - **功能描述**：通过将列表中的每个元素通过转换函数（`iterator`）映射为新值，生成一个新的数组。 - **参数**： - `list`：要映射的列表。 - `iterator`：每次迭代调用的函数。 - **示例**： ```javascript _.map([1, 2, 3], function(num) { return num * 3; }); // [3, 6, 9] _.map({one: 1, two: 2, three: 3}, function(num, key) { return num * 3; }); // [3, 6, 9] ``` - **reduce** - **功能描述**：通过迭代器函数对列表进行累积操作，返回一个单一值。 - **参数**： - `list`：要处理的列表。 - `iterator`：每次迭代调用的函数。 - **示例**： ```javascript _.reduce([1, 2, 3, 4], function(memo, num) { return memo + num; }, 0); // 10 ``` #### 六、总结 Underscore.js 作为一个轻量级且功能强大的工具库，为 JavaScript 开发者提供了众多实用的函数式编程工具。通过上述介绍，我们可以看到 Underscore 在处理数组和对象时的强大能力，尤其是在集合操作方面。无论是初学者还是经验丰富的开发者，都可以从 Underscore 的使用中获益良多。