imported>Zestbot：bot:替換lang-x模板為langx

2025-12-05T08:53:45Z

新页面

{{NoteTA|G1=IT}}
{{Infobox software
| title =
| name = Underscore.js
| logo = Underscore.png
| logo size = 250px
| logo caption =
| screenshot = 
| caption =
| collapsible =
| author =
| developer = {{tsl|en|Jeremy Ashkenas||Jeremy Ashkenas}}和Julian Gonggrijp
| released = {{Start date and age|2009|10|28}}<ref>{{Cite web|url=https://github.com/jashkenas/underscore/releases/tag/0.1.0|title=Release 0.1.0 · jashkenas/underscore|website=GitHub|accessdate=2022年8月25日|archive-date=2022年7月8日|archive-url=https://web.archive.org/web/20220708144830/https://github.com/jashkenas/underscore/releases/tag/0.1.0|dead-url=no}}</ref>
| latest release version = 1.13.4
| latest release date = {{Start date and age|2022|06|02}}
| latest preview version =
| latest preview date =
| programming language = [[JavaScript]]
| operating system =
| platform =
| size = 發行版 7.5 KB<br />開發版 68 KB
| language =
| language count = 
| language footnote =
| genre = [[JavaScript函式庫]]
| license = [[MIT許可證|MIT]]
| alexa =
| website = {{URL|http://underscorejs.org/}}
}}

'''Underscore.js'''是一個綑綁常見功能的[[JavaScript]]函數庫。<ref>{{cite web |title=Underscore.js – ein kleines Framework mit Fokus |url=https://entwickler.de/online/javascript/underscore-js-framework-579836859.html |website=entwickler.de |access-date=9 July 2020 |language=de |date=20 June 2018 |archive-date=2021-04-14 |archive-url=https://web.archive.org/web/20210414060743/https://entwickler.de/online/javascript/underscore-js-framework-579836859.html |dead-url=no }}</ref>Underscore.js提供的功能類似[[Prototype JavaScript框架|Prototype.js]]和[[Ruby]]，但其使用[[函数式编程]]而非[[基于原型编程]]。Underscore.js的文檔將自己稱為「與禮服（[[JQuery]]）和吊帶（Backbone.js）搭配的領帶（{{langx|en|the tie to go along with jQuery's tux, and Backbone.js' suspenders.}}）」。Underscore.js由[[Backbone.js]]和[[CoffeeScript]]的建立者{{tsl|en|Jeremy Ashkenas||Jeremy Ashkenas}}建立。<ref>{{citation |url=https://open.blogs.nytimes.com/2012/04/04/javascript-meetup-city/ |title=JavaScript Meetup City |work=Open |publisher=[[纽约时报]] |date=April 4, 2012 |accessdate=2022-08-19 |archive-date=2017-07-06 |archive-url=https://web.archive.org/web/20170706140000/https://open.blogs.nytimes.com/2012/04/04/javascript-meetup-city/ |dead-url=no }}</ref>

== 歷史 ==
2009年底，為了順利開發{{tsl|en|DocumentCloud||DocumentCloud}}，{{tsl|en|Jeremy Ashkenas||Jeremy Ashkenas}}開發了Underscore。
Underscore為最早提供通用函數式編程實用程序的JavaScript函數庫之一，靈感來自[[Prototype JavaScript框架|Prototype.js]]、Oliver Steele的Functional JavaScript和John Resig的Micro-Templating。<ref>{{cite web |last1=Ashkenas |first1=Jeremy |title=Underscore 0.4.0 source |url=https://cdn.rawgit.com/jashkenas/underscore/0.4.0/underscore.js |website=cdn.rawgit.com |access-date=1 March 2021 |ref=underscore-0-4-0 |archive-date=2021-03-23 |archive-url=https://web.archive.org/web/20210323121659/https://cdn.rawgit.com/jashkenas/underscore/0.4.0/underscore.js |dead-url=no }}</ref>

2012年，John-David Dalton建立Underscore的[[分叉 (软件开发)|分叉]]Lo-Dash（現在的[[Lodash]]）。開發初期，Lo-Dash被評價為「可客製化、效能佳和附加功能多」之Underscore的替代品。<ref>{{cite web |title=Lo-Dash v2.2.1 |url=https://lodash.com |website=lodash.com |access-date=1 March 2021 |ref=lodash-2-2-1-site |archive-url=https://web.archive.org/web/20131106035559/http://lodash.com/ |archive-date=6 November 2013 |url-status=usurped}}</ref>儘管如此，Lodash在分叉早期階段便和Underscore的[[介面_(程式設計)|介面]]有不小的差異<ref>{{cite web |title=Lodash Changelog - 1.0.0 rc1 |url=https://github.com/lodash/lodash/wiki/Changelog#v100-rc1 |website=github.com |access-date=1 March 2021 |ref=lodash-changelog-1-0-0-rc1 |date=4 December 2012 |archive-date=2022-08-17 |archive-url=https://web.archive.org/web/20220817153323/https://github.com/lodash/lodash/wiki/Changelog#v100-rc1 |dead-url=no }}</ref>，甚至在3.0.0版本中開始更劇烈的變更，使得用戶必須要大量變更才能升級到新版本的Lodash或是從Underscore遷移到Lodash。<ref>{{cite web |title=Lodash Changelog - 3.0.0 |url=https://github.com/lodash/lodash/wiki/Changelog#v300 |website=github.com |access-date=1 March 2021 |ref=lodash-changelog-3-0-0 |date=26 January 2015 |archive-date=2022-08-17 |archive-url=https://web.archive.org/web/20220817153323/https://github.com/lodash/lodash/wiki/Changelog#v300 |dead-url=no }}</ref>

2015年5月，Jeremy Ashkenas透露John-David Dalton已與他取得聯繫，希望將Lodash合併回Underscore。縱然代碼風格和代碼大小可能會對合併產生困擾，Ashkenas並不反對將Lodash的一些擴充內容合併到Underscore。<ref>{{cite web |last1=Ashkenas |first1=Jeremy |title=The Big Kahuna: Underscore + Lodash Merge Thread |url=https://github.com/jashkenas/underscore/issues/2182 |website=github.com |access-date=1 March 2021 |ref=underscore-issue-2182 |date=21 May 2015 |archive-date=2022-08-17 |archive-url=https://web.archive.org/web/20220817153324/https://github.com/jashkenas/underscore/issues/2182 |dead-url=no }}</ref>當時有幾個開發人員同時為Underscore和Lodash做出貢獻，這些貢獻者開始對Underscore進行更改，使其更像Lodash。<ref>{{cite web |title=Underscore: merged pull requests with breaking changes between 21 May and 1 October 2015 |url=https://github.com/jashkenas/underscore/pulls?q=is%3Apr+is%3Amerged+created%3A%3E2015-05-21+merged%3A%3C2015-09-01+label%3A%22breaking+change%22 |website=github.com |access-date=1 March 2021 |ref=underscore-breaking-prs-2015 |archive-date=2022-08-17 |archive-url=https://web.archive.org/web/20220817204213/https://github.com/jashkenas/underscore/pulls?q=is:pr+is:merged+created:%3E2015-05-21+merged:%3C2015-09-01+label:%22breaking+change%22 |dead-url=no }}</ref>

然而，在眾人為此努力的同時，Dalton對Lodash的介面進行了更大幅度的更改，並於2015年6月發布Lodash的版本4.0.0。此更改使得Lodash與Underscore介面差距更大，也凸顯了其與Lodash本身的3.x系列版本地不小差異<ref>{{cite web |last1=Dalton |first1=John-David |title=comment on 'Core API' |url=https://github.com/underdash/underdash/issues/4#issuecomment-110026962 |website=github.com |access-date=1 March 2021 |ref=underdash-issue-4-jdalton-comment-110026962 |date=8 June 2015 |archive-date=2022-08-17 |archive-url=https://web.archive.org/web/20220817153508/https://github.com/underdash/underdash/issues/4#issuecomment-110026962 |dead-url=no }}</ref><ref>{{cite web |title=Lodash changelog 4.0.0 |url=https://github.com/lodash/lodash/wiki/Changelog#v400 |website=github.com |access-date=1 March 2021 |ref=lodash-changelog-4-0-0 |date=12 January 2016 |archive-date=2022-08-17 |archive-url=https://web.archive.org/web/20220817153323/https://github.com/lodash/lodash/wiki/Changelog#v400 |dead-url=no }}</ref>，同時此更改也促使一些依賴Lodash的項目分叉了自己的Lodash 3發行版。<ref>{{cite web |title=@sailshq/lodash |url=https://www.npmjs.com/package/@sailshq/lodash |website=npmjs.com |access-date=1 March 2021 |ref=sails-lodash-npm-package |archive-date=2022-08-27 |archive-url=https://web.archive.org/web/20220827002133/https://www.npmjs.com/package/@sailshq/lodash |dead-url=no }}</ref>

2016年2月，Dalton宣布他認為合併工作已經完成，並建議Underscore用戶切換到Lodash。<ref>{{cite web |last1=Dalton |first1=John-David |title=Merge update. |url=https://github.com/underdash/underdash/issues/14 |website=github.com |access-date=1 March 2021 |ref=underdash-issue-14 |date=13 February 2016 |archive-date=2020-10-12 |archive-url=https://web.archive.org/web/20201012052706/https://github.com/underdash/underdash/issues/14 |dead-url=no }}</ref>然而，Underscore的維護者明確表示，Underscore依然會作為單獨的庫存在。<ref>{{cite web |last1=Krebs |first1=Adam |title=comment on 'Merge update.' |url=https://github.com/underdash/underdash/issues/14#issuecomment-185279839 |website=github.com |access-date=1 March 2021 |ref=underdash-issue-14-comment-185279839 |date=17 February 2016 |archive-date=2020-10-12 |archive-url=https://web.archive.org/web/20201012052706/https://github.com/underdash/underdash/issues/14#issuecomment-185279839 |dead-url=no }}</ref>兩個函數庫在 2016 年之後都進入了低開發活動狀態。<ref name="underscore-contributors">{{cite web |title=jashkenas/underscore Insights: Contributors |url=https://github.com/jashkenas/underscore/graphs/contributors |website=github.com |access-date=1 March 2021 |ref=underscore-contributors |archive-date=2022-08-17 |archive-url=https://web.archive.org/web/20220817153458/https://github.com/jashkenas/underscore/graphs/contributors |dead-url=no }}</ref><ref>{{cite web |title=lodash/lodash Insight: Contributors |url=https://github.com/lodash/lodash/graphs/contributors |website=github.com |access-date=1 March 2021 |ref=lodash-contributors |archive-date=2022-08-17 |archive-url=https://web.archive.org/web/20220817153456/https://github.com/lodash/lodash/graphs/contributors |dead-url=no }}</ref>

隨著時間的推移，較新版本的[[ECMAScript]]標準借鑒了Underscore的部分功能，例如<code>Object.assign</code>和<code>Array.prototype.map</code>。儘管這些內置函數不如Underscore等效函數強大，此變更依然使得部分人認為Underscore不再為JavaScript項目增加價值。然而，新加入的數組功能只能在數組上使用，而非如同Underscore一樣可以適用任意迭代對象。<ref>{{cite web |title=Array.prototype.map |url=https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map |website=developer.mozilla.org |access-date=1 March 2021 |ref=mdn-array-map |archive-date=2022-09-08 |archive-url=https://web.archive.org/web/20220908223951/https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/Map |dead-url=no }}</ref><ref>{{cite web |title=Array.prototype.filter |url=https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter |website=developer.mozilla.org |access-date=1 March 2021 |ref=mdn-array-filter |archive-date=2022-09-08 |archive-url=https://web.archive.org/web/20220908203748/https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter |dead-url=no }}</ref><ref>{{cite web |title=Array.prototype.forEach |url=https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach |website=developer.mozilla.org |access-date=1 March 2021 |ref=mdn-array-forEach |archive-date=2022-09-08 |archive-url=https://web.archive.org/web/20220908203750/https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach |dead-url=no }}</ref><ref>{{cite web |title=_.map |url=https://underscorejs.org/#map |website=underscorejs.org |access-date=1 March 2021 |ref=underscore-map |archive-date=2022-09-09 |archive-url=https://web.archive.org/web/20220909023026/http://underscorejs.org/#map |dead-url=no }}</ref><ref>{{cite web |title=_.filter |url=https://underscorejs.org/#filter |website=underscorejs.org |access-date=1 March 2021 |ref=underscore-filter |archive-date=2022-09-09 |archive-url=https://web.archive.org/web/20220909023026/http://underscorejs.org/#filter |dead-url=no }}</ref><ref>{{cite web |title=_.each |url=https://underscorejs.org/#each |website=underscorejs.org |access-date=1 March 2021 |ref=underscore-each |archive-date=2022-09-09 |archive-url=https://web.archive.org/web/20220909023026/http://underscorejs.org/#each |dead-url=no }}</ref>除此之外，Underscore的大部分函數仍然沒有內置對應函數。<ref>{{cite web |title=Underscore.js |url=https://underscorejs.org/ |website=underscorejs.org |access-date=1 March 2021 |ref=underscore-website |archive-date=2022-09-09 |archive-url=https://web.archive.org/web/20220909023026/http://underscorejs.org/ |dead-url=no }}</ref><ref>{{cite web |title=JavaScript reference |url=https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference |website=developer.mozilla.org |access-date=1 March 2021 |ref=mdn-js-ref |archive-date=2022-09-04 |archive-url=https://web.archive.org/web/20220904020728/https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference |dead-url=no }}</ref>

截至2021年3月，Julian Gonggrijp正在積極開發Underscore，他於2020年3月開始做出重大貢獻。<ref name="underscore-contributors" />至今仍有許多函數庫依賴Underscore，[[Npm|npm]]上的每週下載次依然高達數百萬次。<ref>{{cite web |title=underscore |url=https://www.npmjs.com/package/underscore |website=npmjs.com |access-date=1 March 2021 |ref=npm-underscore |archive-date=2022-08-17 |archive-url=https://web.archive.org/web/20220817153321/https://www.npmjs.com/package/underscore |dead-url=no }}</ref>

== 內容 ==

簡而言之，Underscore提供了三大功能：

# 100多個泛用函數集合。[https://underscorejs.org/ 文檔] {{Wayback|url=https://underscorejs.org/ |date=20220909023026 }}區分出了幾個類別：
#* '''集合函數'''，例如<code>find</code>、<code>map</code>、<code>min</code>／<code>max</code>、<code>groupBy</code>和<code>shuffle</code>，這些函數可以對迭代物件的元素進行操作。
#* '''數組函數'''，例如<code>first</code>／<code>last</code>、<code>flatten</code>、<code>chunk</code>和<code>zip</code>，這些函數可以對類數組物件進行操作。
#* '''函數函數'''，例如<code>bind</code>、<code>memoize</code>、<code>partial</code>和<code>debounce</code>，這些函數將函數作為參數並返回具有改變屬性的新函數（[[高阶函数]]）。
#* '''物件函數'''為最基礎的類別，包含許多也在Underscore內部使用的函數。<ref>{{cite web |last1=Gonggrijp |first1=Julian |title=modules/index.js |url=https://underscorejs.org/docs/modules/index.html |website=underscorejs.org |access-date=5 March 2021 |ref=underscore-index |archive-date=2022-08-17 |archive-url=https://web.archive.org/web/20220817153526/https://underscorejs.org/docs/modules/index.html |dead-url=no }}</ref>物件函數大致可以分為兩個子類：
#** '''類型檢測函數'''，例如<code>isNumber</code>、<code>isElement</code>和<code>isDataView</code>。
#** '''物件數據函數'''，例如<code>keys</code>、<code>extend</code>、<code>pick</code>／<code>omit</code>、<code>pairs</code>和<code>invert</code>，這些函數將一般物件作為數據進行操作。
#* '''實用函數'''是一個雜項類別，其中包括瑣碎功能如<code>identity</code>和<code>noop</code>和字符串操作函數<code>escape</code>、<code>unescape</code>和<code>template</code>。此類別還包括函數<code>iteratee</code>和<code>mixin</code>，它們可以被視為第2點中提及的特殊工具。
# 特殊工具，例如<code>chain</code>和<code>iteratee</code>，這些特殊工具與第1點的函數相結合用以實現更短、更清晰的語法。以庫命名的特殊函數 <code>_</code> 是這些設施的核心。
需要閱讀的有文化的源代碼，以便很容易理解庫的實現方式。文檔包括源代碼的渲染版本，其中註釋在左側，邏輯在右側。註釋使用Markdown格式化，邏輯有語法高亮。從 1.11 版本開始，Underscore 是模塊化的。出於這個原因，文檔現在包括帶註釋源的模塊化版本，其中每個功能都在一個單獨的頁面上，並且import引用是可點擊的超鏈接，以及一個單一閱讀版本，其中所有功能都在一個頁面上依賴順序。
# 使用[[文学编程]]進行編程，故程式碼較容易閱讀，且較容易理解函數庫的實現方式。Underscore文檔加入了源始碼的渲染版本，其中註釋在左側，邏輯在右側。註釋使用[[Markdown]]格式化，邏輯加上了[[語法突顯]]。自1.11版起，Underscore進行了模組化，因此文檔也同步加入了[https://underscorejs.org/docs/modules/index-all.html 模組化版本] {{Wayback|url=https://underscorejs.org/docs/modules/index-all.html |date=20220817153502 }}，每個功能都在一個單獨的頁面上，並且import引用是可點擊的[[超連結]]；同時也文檔也提供了一個[https://underscorejs.org/docs/underscore-esm.html 匯集所有模組的版本] {{Wayback|url=https://underscorejs.org/docs/underscore-esm.html |date=20220817153322 }}，使用[[拓撲排序]]進行排序。

=== 功能概述和示例 ===

Underscore使用[[函数式编程]]，故而可以將多個函數混和成新的{{tsl|en|expression (computer science)||表達式}}。例如下方的程式碼便是使用兩個Underscore函數以使用第一個字元進行分組：

<syntaxhighlight lang="js" line="1">
import { groupBy, first } from 'underscore';

groupBy(['avocado', 'apricot', 'cherry', 'date', 'durian'], first);

// result:
// { a: ['avocado', 'apricot'],
// c: ['cherry'],
// d: ['date', 'durian']
// }
</syntaxhighlight>

除了使用Underscore內建的函數，也可以自訂函數。例如下方程式碼實踐了自己的<code>first</code>函數，其結果和上方程式碼相同：

<syntaxhighlight lang="js" line="1">
import { groupBy } from 'underscore';

const first = array => array[0];

groupBy(['avocado', 'apricot', 'cherry', 'date', 'durian'], first);
</syntaxhighlight>

Underscore內建不少這類型的函數，以便程序員可以從現有函數組合功能，而非每次都要自己實踐。

正常情況下，第一個參數會傳入迭代對象，第二個參數傳入迭代函數或''iteratee''。上方示例中，<code>first</code>是傳遞給<code>groupBy</code>的迭代函數。

iteratee會接收三個參數：
# 集合中當前位置的值
# 該值的鍵或索引
# 整個集合
下方示例中使用了<code>pick</code>的第二個參數，過濾掉鍵名首字母不是大寫字母的屬性：

<syntaxhighlight lang="js" line="1">
import { pick } from 'underscore';

const details = {
Official: 'Wolfgang Amadeus Mozart',
informal: 'Wolfie'
};
const keyIsUpper = (value, key) => key[0] === key[0].toUpperCase();

pick(details, keyIsUpper);
// {Official: 'Wolfgang Amadeus Mozart'}
</syntaxhighlight>

許多Underscore的函數都可以當作迭代函數，如第一個範例使用的<code>first</code>。除此之外，程序員還可以使用[[#迭代縮寫|迭代縮寫]]以避開編寫迭代函數。下方示例中，迭代縮寫為字符串<code>'name'</code>，以從迭代對象提取鍵值為<code>name</code>的屬性：

<syntaxhighlight lang="js" line="1">
import { map } from 'underscore';

const people = [
{name: 'Lily', age: 44, occupation: 'librarian'},
{name: 'Harold', age: 10, occupation: 'dreamer'},
{name: 'Sasha', age: 68, occupation: 'library developer'}
];

map(people, 'name'); // ['Lily', 'Harold', 'Sasha']
</syntaxhighlight>

「集合」類別中的所有函數，包括上方範例的<code>groupBy</code>和<code>map</code>函數，都可以遍歷迭代對象的索引和對象的鍵。下方示例使用函數<code>reduce</code>說明：

<syntaxhighlight lang="js" line="1">
import { reduce } from 'underscore';

const add = (a, b) => a + b;
const sum = numbers => reduce(numbers, add, 0);

sum([11, 12, 13]); // 36
sum({Alice: 9, Bob: 9, Clair: 7}); // 25
</syntaxhighlight>

除了遍歷數組或對象的函數外，Underscore還提供了廣泛的其他常用函數，例如<code>throttle</code>限制了目標函數的最大呼叫頻率：

<syntaxhighlight lang="js" line="1">
import { throttle } from 'underscore';

// The scroll event triggers very often, so the following line may
// slow down the browser.
document.body.addEventListener('scroll', expensiveUpdateFunction);

// Limit evaluation to once every 100 milliseconds.
const throttledUpdateFunction = throttle(expensiveUpdateFunction, 100);

// Much smoother user experience!
document.body.addEventListener('scroll', throttledUpdateFunction);
</syntaxhighlight>

另一個例子是<code>defaults</code>函數，僅在尚未設置時才分配對象屬性：

<syntaxhighlight lang="js" line="1">
import { defaults } from 'underscore';

const requestData = {
url: 'wikipedia.org',
method: 'POST',
body: 'article text'
};
const defaultFields = {
method: 'GET',
headers: {'X-Requested-With': 'XMLHttpRequest'}
};

defaults(requestData, defaultFields);
// {
// url: 'wikipedia.org',
// method: 'POST',
// body: 'article text',
// headers: {'X-Requested-With': 'XMLHttpRequest'}
// }
</syntaxhighlight>

=== <code>_</code>函數 ===

Underscore的名字來源於多種用途的<code>_</code>函數。

==== 包裝函數 ====

Underscore的主函數<code>_</code>將第一個參數包裝起來，返回一個可以呼叫所有Underscore的函數的方法，此時第一個參數將作為這些函數的第一個參數傳入。此方法又被稱作「OOP樣式」，專門用於「{{link-en|連結|next section}}」。

<syntaxhighlight lang="js" line="1">
import _, { last } from 'underscore';

// "Normal" or "functional" style
last([1, 2, 3]); // 3

// "OOP style"
_([1, 2, 3]).last() // 3
</syntaxhighlight>

可以透過<code>.value()</code>拿到原始傳入的值，在JavaScript的自動轉型下也會自己展開：

<syntaxhighlight lang="js" line="1">
// Explicit unwrap
_([1, 2, 3]).value() // [1, 2, 3]

// Automatic unwrap when coerced to number
1 + _(2) // 3

// Automatic unwrap when coerced to string
'abc' + _('def') // 'abcdef'

// Automatic unwrap when formatted as JSON
JSON.stringify({ a: _([1, 2]) }) // '{"a":[1,2]}'
</syntaxhighlight>

==== 部份套用佔位符 ====

<code>_</code>函數還可以用來當作<code>partial</code>函數的佔位符。<code>partial</code>用來建立一個函數的{{tsl|en|partial application||部份套用}}版本，而<code>_</code>函數可用於使某些參數「打開（{{langx|en|open}}）」，而這些參數可以在後續呼叫中再傳入。例如{{section||功能概述和示例}}一節提到的<code>groupBy</code>範例可以改變成下方的用法以方便重複使用：

<syntaxhighlight lang="js" line="1">
import _, { partial, groupBy, first } from 'underscore';

const groupByFirstChar = partial(groupBy, _, first);

groupByFirstChar(['avocado', 'apricot', 'cherry', 'date', 'durian']);
// { a: ['avocado', 'apricot'],
// c: ['cherry'],
// d: ['date', 'durian']
// }

groupByFirstChar(['chestnut', 'pistache', 'walnut', 'cashew']);
// { c: ['chestnut', 'cashew'],
// p: ['pistache'],
// w: ['walnut]
// }
</syntaxhighlight>

==== 自定義入口點 ====

<code>_</code>也可做為{{tsl|en|personalization||自定義}}Underscore函數的入口點，程序員可以根據需要調整Underscore函數的行為。具體來說，用戶可以重寫<code>_.iteratee</code>以建立新的{{tsl|en|iteratee shorthands||迭代縮寫}}，又或是重寫<code>_.templateSettings</code>以自定義<code>template</code>函數。

==== 命名空間 ====

<code>_</code>在舊式的{{tsl|en|Asynchronous module definition||AMD}}模組系統和[[CommonJS]]模組系統中也同時作為[[命名空間]]存在，即''所有''Underscore函數都包含在此一命名空間中，例如<code>_.map</code>和<code>_.debounce</code>。在JavaScript發展出[[ECMAScript|ES6]]的[[模块化编程|模組系統]]後命名空間已無必要性。

<syntaxhighlight lang="js" line="1">
var _ = require('underscore');

_.groupBy(['avocado', 'apricot', 'cherry', 'date', 'durian'], _.first);
</syntaxhighlight>

命名空間也可以用於區分不同模組提供的函數，比如Underscore和[https://caolan.github.io/async/v3/ Async] {{Wayback|url=https://caolan.github.io/async/v3/ |date=20220616051257 }}都提供了名為<code>each</code>的函數，可以分別使用<code>_.each</code>和<code>async.each</code>來區分這些函數。

=== 連結 ===

The function <code>chain</code> can be used to create a modified version of the wrapper produced by [[#_函數|<code>_</code>函數]]. When invoked on such a ''chained wrapper'', each method returns a new wrapper so that the user can continue to process intermediate results with Underscore functions:
<code>chain</code>函數用來建立由[[#_函數|<code>_</code>函數]]生成的包裝物件的修改版本。當在這種「鍊式包裝器（{{langx|en|chained wrapper}}）」上調用時，每個方法都會返回一個新的包裝物件，以便用戶可以連續使用Underscore函數：

<syntaxhighlight lang="js" line="1">
import { chain } from 'underscore';

const square = x => x * x;
const isOdd = x => x % 2;

chain([1, 2, 3, 4]).filter(isOdd).map(square).last()
// returns a wrapper of 9
</syntaxhighlight>

也可以使用<code>.value()</code>結束Underscore函數群搭配<code>return</code>語法：

<syntaxhighlight lang="js" line="8">
const add = (x, y) => x + y;

// Given an array of numbers, return the sum of the squares of
// those numbers. This could be used in a statistics library.
function sumOfSquares(numbers) {
return chain(numbers)
.map(square)
.reduce(add)
.value();
}
</syntaxhighlight>

連結並不是Underscore內建的函數獨有的功能。程序員也可以傳遞自定義函數給<code>mixin</code>函數來為自己的函數啟用連結：

<syntaxhighlight lang="js" line="18">
import { reduce, mixin } from 'underscore';

const sum = numbers => reduce(numbers, add, 0);

mixin({ sum, square });

chain([1, 2, 3]).map(square).sum().value(); // 14
chain([1, 2, 3]).sum().square().value(); // 36
</syntaxhighlight>

實際上Underscore內建的函數都是使用此方法來啟用連結，即先編寫為獨立函數，而後「混合」到<code>_</code>函數中。<ref>{{cite web |last1=Gonggrijp |first1=Julian |title=modules/index-default.js |url=https://underscorejs.org/docs/modules/index-default.html |website=underscorejs.org |access-date=4 March 2021 |ref=underscore-index-default |archive-date=2022-08-17 |archive-url=https://web.archive.org/web/20220817153459/https://underscorejs.org/docs/modules/index-default.html |dead-url=no }}</ref>

=== 迭代縮寫 ===

如同{{section||功能概述和示例}}所述，大多數Underscore的迭代函數都可使用迭代縮寫（{{langx|en|iteratee shorthand}}）代替取代函數。下方範例使用了前面章節的範例來演示：

<syntaxhighlight lang="js" line="1">
import { map } from 'underscore';

const people = [
{name: 'Lily', details: {age: 44, occupation: 'fire fighter'}},
{name: 'Harold', details: {age: 10, occupation: 'dreamer'}},
{name: 'Sasha', details: {age: 68, occupation: 'library developer'}}
];

map(people, 'name'); // ['Lily', 'Harold', 'Sasha']
</syntaxhighlight>

實際上，這些迭代函數是將通過將簡寫值傳遞給<code>_.iteratee</code>來確定實際調用的函數，而<code>_.iteratee</code>默認為Underscore內建的<code>iteratee</code>函數，此函數根據參數值返回下列幾種函數：

==== 路徑 ====

當傳入值是一個字符串，<code>iteratee</code>函數會將傳入值傳入<code>property</code>函數，此函數用於過濾鍵名與傳入值相同的鍵值。

<syntaxhighlight lang="js" line="9">
import { iteratee, property } from 'underscore';

map(people, 'name');
map(people, iteratee('name'));
map(people, property('name'));
map(people, obj => obj && obj['name']);
// ['Lily', 'Harold', 'Sasha']
</syntaxhighlight>

也可以傳入陣列。當傳入陣列時，<code>property</code>函數將遞迴搜尋目標屬性。

<syntaxhighlight lang="js" line="9">
map(people, ['details', 'occupation']);
// ['fire fighter', 'dreamer', 'library developer']
</syntaxhighlight>

也可以傳入數字，傳入數字時將作為數組和字符串索引。

結合上方功能，下方範例給出了計算職業名稱中第二個字符出現的次數的方法：

<syntaxhighlight lang="js" line="9">
import { countBy } from 'underscore';

countBy(people, ['details', 'occupation', 1]); // {i: 2, r: 1}
</syntaxhighlight>

==== 屬性雜湊 ====

當傳入值是一個物件，<code>iteratee</code>函數會將傳入值傳入<code>matcher</code>函數，此函數會檢查鍵名與鍵值是否皆有匹配，並依照是否匹配返回<code>true</code>或<code>false</code>。

<syntaxhighlight lang="js" line="9">
import { find } from 'underscore';

find(people, {name: 'Sasha'});
// {name: 'Sasha', details: {age: 68, occupation: 'library developer'}}

find(people, {name: 'Walter'});
// undefined
</syntaxhighlight>

==== <code>null</code>和<code>undefined</code> ====

當傳入值是<code>null</code>或<code>undefined</code>，<code>iteratee</code>函數返回一個[[恆等函數]]<code>identity</code>。此函數用於過濾數組值在JavaScript中強制轉型為布林值時為<code>true</code>或<code>false</code>。

<syntaxhighlight lang="js" line="1">
import { filter, iteratee, identity } from 'underscore';

const example = [0, 1, '', 'abc', true, false, {}];

// The following expressions are all equivalent.
filter(example);
filter(example, undefined);
filter(example, iteratee(undefined));
filter(example, identity);
// [1, 'abc', true, {}]
</syntaxhighlight>

==== 覆蓋<code>_.iteratee</code> ====

程序員可以通過覆蓋<code>_.iteratee</code>來增加自定義的迭代縮寫。下方範例描述如何新增[[正規表達法]]作為迭代縮寫。

<syntaxhighlight lang="js" line="1">
import {
iteratee as originalIteratee,
isRegExp,
mixin,
filter,
} from 'underscore';

function iteratee(value, context) {
if (isRegExp(value)) {
return string => value.test(string);
} else {
return originalIteratee(value, context);
}
}

mixin({iteratee});

filter(['absolutely', 'amazing', 'fabulous', 'trousers'], /ab/);
// ['absolutely', 'fabulous']
</syntaxhighlight>

== 參考文獻 ==
{{Reflist}}

== 外部連結 ==
*{{Official website|https://underscorejs.org/}}
*[https://web.archive.org/web/20081201075555/https://osteele.com/sources/javascript/functional/ Functional Javascript] by Oliver Steele (internet archive; osteele.com only retains a [https://osteele.com/functional-javascript/ae8ve7ulujbtdu0zcu6qfuhq3sbegu screenshot]{{Dead link}})
*[https://johnresig.com/blog/javascript-micro-templating/ JavaScript Micro-Templating] {{Wayback|url=https://johnresig.com/blog/javascript-micro-templating/ |date=20220810035513 }} by John Resig, the original inspiration for [https://underscorejs.org/#template <code>_.template</code>] {{Wayback|url=https://underscorejs.org/#template |date=20220909023026 }}

{{JS templating |state=autocollapse}}
{{NodeJs}}

== 參見 ==
{{Portal|自由軟體}}

* [[Lodash]]
* [[Prototype JavaScript框架|Prototype.js]]
* [[Web应用框架]]
* [[JavaScript函式庫]]

[[Category:JavaScript函式庫]]
[[Category:使用MIT许可证的软件]]

Underscore.js - 版本历史

imported>Zestbot：​bot:替換lang-x模板為langx

imported>Zestbot：bot:替換lang-x模板為langx