Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
C
converse.js
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
nexedi
converse.js
Commits
50ee481d
Commit
50ee481d
authored
Mar 27, 2013
by
JC Brand
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Bump underscore.js to 1.4.4
parent
07a65f5b
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
450 additions
and
283 deletions
+450
-283
Libraries/underscore.js
Libraries/underscore.js
+450
-283
No files found.
Libraries/underscore.js
View file @
50ee481d
// Underscore.js 1.3.3
// Underscore.js 1.4.4
// (c) 2009-2012 Jeremy Ashkenas, DocumentCloud Inc.
// http://underscorejs.org
// Underscore is freely distributable under the MIT license.
// (c) 2009-2013 Jeremy Ashkenas, DocumentCloud Inc.
// Portions of Underscore are inspired or borrowed from Prototype,
// Underscore may be freely distributed under the MIT license.
// Oliver Steele's Functional, and John Resig's Micro-Templating.
// For all details and documentation:
// http://documentcloud.github.com/underscore
(
function
()
{
(
function
()
{
...
@@ -24,8 +21,9 @@
...
@@ -24,8 +21,9 @@
var
ArrayProto
=
Array
.
prototype
,
ObjProto
=
Object
.
prototype
,
FuncProto
=
Function
.
prototype
;
var
ArrayProto
=
Array
.
prototype
,
ObjProto
=
Object
.
prototype
,
FuncProto
=
Function
.
prototype
;
// Create quick reference variables for speed access to core prototypes.
// Create quick reference variables for speed access to core prototypes.
var
slice
=
ArrayProto
.
slice
,
var
push
=
ArrayProto
.
push
,
unshift
=
ArrayProto
.
unshift
,
slice
=
ArrayProto
.
slice
,
concat
=
ArrayProto
.
concat
,
toString
=
ObjProto
.
toString
,
toString
=
ObjProto
.
toString
,
hasOwnProperty
=
ObjProto
.
hasOwnProperty
;
hasOwnProperty
=
ObjProto
.
hasOwnProperty
;
...
@@ -46,7 +44,11 @@
...
@@ -46,7 +44,11 @@
nativeBind
=
FuncProto
.
bind
;
nativeBind
=
FuncProto
.
bind
;
// Create a safe reference to the Underscore object for use below.
// Create a safe reference to the Underscore object for use below.
var
_
=
function
(
obj
)
{
return
new
wrapper
(
obj
);
};
var
_
=
function
(
obj
)
{
if
(
obj
instanceof
_
)
return
obj
;
if
(
!
(
this
instanceof
_
))
return
new
_
(
obj
);
this
.
_wrapped
=
obj
;
};
// Export the Underscore object for **Node.js**, with
// Export the Underscore object for **Node.js**, with
// backwards-compatibility for the old `require()` API. If we're in
// backwards-compatibility for the old `require()` API. If we're in
...
@@ -58,11 +60,11 @@
...
@@ -58,11 +60,11 @@
}
}
exports
.
_
=
_
;
exports
.
_
=
_
;
}
else
{
}
else
{
root
[
'
_
'
]
=
_
;
root
.
_
=
_
;
}
}
// Current version.
// Current version.
_
.
VERSION
=
'
1.
3.3
'
;
_
.
VERSION
=
'
1.
4.4
'
;
// Collection Functions
// Collection Functions
// --------------------
// --------------------
...
@@ -76,7 +78,7 @@
...
@@ -76,7 +78,7 @@
obj
.
forEach
(
iterator
,
context
);
obj
.
forEach
(
iterator
,
context
);
}
else
if
(
obj
.
length
===
+
obj
.
length
)
{
}
else
if
(
obj
.
length
===
+
obj
.
length
)
{
for
(
var
i
=
0
,
l
=
obj
.
length
;
i
<
l
;
i
++
)
{
for
(
var
i
=
0
,
l
=
obj
.
length
;
i
<
l
;
i
++
)
{
if
(
i
in
obj
&&
i
terator
.
call
(
context
,
obj
[
i
],
i
,
obj
)
===
breaker
)
return
;
if
(
iterator
.
call
(
context
,
obj
[
i
],
i
,
obj
)
===
breaker
)
return
;
}
}
}
else
{
}
else
{
for
(
var
key
in
obj
)
{
for
(
var
key
in
obj
)
{
...
@@ -96,10 +98,11 @@
...
@@ -96,10 +98,11 @@
each
(
obj
,
function
(
value
,
index
,
list
)
{
each
(
obj
,
function
(
value
,
index
,
list
)
{
results
[
results
.
length
]
=
iterator
.
call
(
context
,
value
,
index
,
list
);
results
[
results
.
length
]
=
iterator
.
call
(
context
,
value
,
index
,
list
);
});
});
if
(
obj
.
length
===
+
obj
.
length
)
results
.
length
=
obj
.
length
;
return
results
;
return
results
;
};
};
var
reduceError
=
'
Reduce of empty array with no initial value
'
;
// **Reduce** builds up a single result from a list of values, aka `inject`,
// **Reduce** builds up a single result from a list of values, aka `inject`,
// or `foldl`. Delegates to **ECMAScript 5**'s native `reduce` if available.
// or `foldl`. Delegates to **ECMAScript 5**'s native `reduce` if available.
_
.
reduce
=
_
.
foldl
=
_
.
inject
=
function
(
obj
,
iterator
,
memo
,
context
)
{
_
.
reduce
=
_
.
foldl
=
_
.
inject
=
function
(
obj
,
iterator
,
memo
,
context
)
{
...
@@ -117,7 +120,7 @@
...
@@ -117,7 +120,7 @@
memo
=
iterator
.
call
(
context
,
memo
,
value
,
index
,
list
);
memo
=
iterator
.
call
(
context
,
memo
,
value
,
index
,
list
);
}
}
});
});
if
(
!
initial
)
throw
new
TypeError
(
'
Reduce of empty array with no initial value
'
);
if
(
!
initial
)
throw
new
TypeError
(
reduceError
);
return
memo
;
return
memo
;
};
};
...
@@ -130,9 +133,22 @@
...
@@ -130,9 +133,22 @@
if
(
context
)
iterator
=
_
.
bind
(
iterator
,
context
);
if
(
context
)
iterator
=
_
.
bind
(
iterator
,
context
);
return
initial
?
obj
.
reduceRight
(
iterator
,
memo
)
:
obj
.
reduceRight
(
iterator
);
return
initial
?
obj
.
reduceRight
(
iterator
,
memo
)
:
obj
.
reduceRight
(
iterator
);
}
}
var
reversed
=
_
.
toArray
(
obj
).
reverse
();
var
length
=
obj
.
length
;
if
(
context
&&
!
initial
)
iterator
=
_
.
bind
(
iterator
,
context
);
if
(
length
!==
+
length
)
{
return
initial
?
_
.
reduce
(
reversed
,
iterator
,
memo
,
context
)
:
_
.
reduce
(
reversed
,
iterator
);
var
keys
=
_
.
keys
(
obj
);
length
=
keys
.
length
;
}
each
(
obj
,
function
(
value
,
index
,
list
)
{
index
=
keys
?
keys
[
--
length
]
:
--
length
;
if
(
!
initial
)
{
memo
=
obj
[
index
];
initial
=
true
;
}
else
{
memo
=
iterator
.
call
(
context
,
memo
,
obj
[
index
],
index
,
list
);
}
});
if
(
!
initial
)
throw
new
TypeError
(
reduceError
);
return
memo
;
};
};
// Return the first value which passes a truth test. Aliased as `detect`.
// Return the first value which passes a truth test. Aliased as `detect`.
...
@@ -162,18 +178,16 @@
...
@@ -162,18 +178,16 @@
// Return all the elements for which a truth test fails.
// Return all the elements for which a truth test fails.
_
.
reject
=
function
(
obj
,
iterator
,
context
)
{
_
.
reject
=
function
(
obj
,
iterator
,
context
)
{
var
results
=
[];
return
_
.
filter
(
obj
,
function
(
value
,
index
,
list
)
{
if
(
obj
==
null
)
return
results
;
return
!
iterator
.
call
(
context
,
value
,
index
,
list
);
each
(
obj
,
function
(
value
,
index
,
list
)
{
},
context
);
if
(
!
iterator
.
call
(
context
,
value
,
index
,
list
))
results
[
results
.
length
]
=
value
;
});
return
results
;
};
};
// Determine whether all of the elements match a truth test.
// Determine whether all of the elements match a truth test.
// Delegates to **ECMAScript 5**'s native `every` if available.
// Delegates to **ECMAScript 5**'s native `every` if available.
// Aliased as `all`.
// Aliased as `all`.
_
.
every
=
_
.
all
=
function
(
obj
,
iterator
,
context
)
{
_
.
every
=
_
.
all
=
function
(
obj
,
iterator
,
context
)
{
iterator
||
(
iterator
=
_
.
identity
);
var
result
=
true
;
var
result
=
true
;
if
(
obj
==
null
)
return
result
;
if
(
obj
==
null
)
return
result
;
if
(
nativeEvery
&&
obj
.
every
===
nativeEvery
)
return
obj
.
every
(
iterator
,
context
);
if
(
nativeEvery
&&
obj
.
every
===
nativeEvery
)
return
obj
.
every
(
iterator
,
context
);
...
@@ -197,23 +211,22 @@
...
@@ -197,23 +211,22 @@
return
!!
result
;
return
!!
result
;
};
};
// Determine if a given value is included in the array or object using `===`.
// Determine if the array or object contains a given value (using `===`).
// Aliased as `contains`.
// Aliased as `include`.
_
.
include
=
_
.
contains
=
function
(
obj
,
target
)
{
_
.
contains
=
_
.
include
=
function
(
obj
,
target
)
{
var
found
=
false
;
if
(
obj
==
null
)
return
false
;
if
(
obj
==
null
)
return
found
;
if
(
nativeIndexOf
&&
obj
.
indexOf
===
nativeIndexOf
)
return
obj
.
indexOf
(
target
)
!=
-
1
;
if
(
nativeIndexOf
&&
obj
.
indexOf
===
nativeIndexOf
)
return
obj
.
indexOf
(
target
)
!=
-
1
;
found
=
any
(
obj
,
function
(
value
)
{
return
any
(
obj
,
function
(
value
)
{
return
value
===
target
;
return
value
===
target
;
});
});
return
found
;
};
};
// Invoke a method (with arguments) on every item in a collection.
// Invoke a method (with arguments) on every item in a collection.
_
.
invoke
=
function
(
obj
,
method
)
{
_
.
invoke
=
function
(
obj
,
method
)
{
var
args
=
slice
.
call
(
arguments
,
2
);
var
args
=
slice
.
call
(
arguments
,
2
);
var
isFunc
=
_
.
isFunction
(
method
);
return
_
.
map
(
obj
,
function
(
value
)
{
return
_
.
map
(
obj
,
function
(
value
)
{
return
(
_
.
isFunction
(
method
)
?
method
||
value
:
value
[
method
]).
apply
(
value
,
args
);
return
(
isFunc
?
method
:
value
[
method
]).
apply
(
value
,
args
);
});
});
};
};
...
@@ -222,11 +235,33 @@
...
@@ -222,11 +235,33 @@
return
_
.
map
(
obj
,
function
(
value
){
return
value
[
key
];
});
return
_
.
map
(
obj
,
function
(
value
){
return
value
[
key
];
});
};
};
// Convenience version of a common use case of `filter`: selecting only objects
// containing specific `key:value` pairs.
_
.
where
=
function
(
obj
,
attrs
,
first
)
{
if
(
_
.
isEmpty
(
attrs
))
return
first
?
null
:
[];
return
_
[
first
?
'
find
'
:
'
filter
'
](
obj
,
function
(
value
)
{
for
(
var
key
in
attrs
)
{
if
(
attrs
[
key
]
!==
value
[
key
])
return
false
;
}
return
true
;
});
};
// Convenience version of a common use case of `find`: getting the first object
// containing specific `key:value` pairs.
_
.
findWhere
=
function
(
obj
,
attrs
)
{
return
_
.
where
(
obj
,
attrs
,
true
);
};
// Return the maximum element or (element-based computation).
// Return the maximum element or (element-based computation).
// Can't optimize arrays of integers longer than 65,535 elements.
// See: https://bugs.webkit.org/show_bug.cgi?id=80797
_
.
max
=
function
(
obj
,
iterator
,
context
)
{
_
.
max
=
function
(
obj
,
iterator
,
context
)
{
if
(
!
iterator
&&
_
.
isArray
(
obj
)
&&
obj
[
0
]
===
+
obj
[
0
])
return
Math
.
max
.
apply
(
Math
,
obj
);
if
(
!
iterator
&&
_
.
isArray
(
obj
)
&&
obj
[
0
]
===
+
obj
[
0
]
&&
obj
.
length
<
65535
)
{
return
Math
.
max
.
apply
(
Math
,
obj
);
}
if
(
!
iterator
&&
_
.
isEmpty
(
obj
))
return
-
Infinity
;
if
(
!
iterator
&&
_
.
isEmpty
(
obj
))
return
-
Infinity
;
var
result
=
{
computed
:
-
Infinity
};
var
result
=
{
computed
:
-
Infinity
,
value
:
-
Infinity
};
each
(
obj
,
function
(
value
,
index
,
list
)
{
each
(
obj
,
function
(
value
,
index
,
list
)
{
var
computed
=
iterator
?
iterator
.
call
(
context
,
value
,
index
,
list
)
:
value
;
var
computed
=
iterator
?
iterator
.
call
(
context
,
value
,
index
,
list
)
:
value
;
computed
>=
result
.
computed
&&
(
result
=
{
value
:
value
,
computed
:
computed
});
computed
>=
result
.
computed
&&
(
result
=
{
value
:
value
,
computed
:
computed
});
...
@@ -236,9 +271,11 @@
...
@@ -236,9 +271,11 @@
// Return the minimum element (or element-based computation).
// Return the minimum element (or element-based computation).
_
.
min
=
function
(
obj
,
iterator
,
context
)
{
_
.
min
=
function
(
obj
,
iterator
,
context
)
{
if
(
!
iterator
&&
_
.
isArray
(
obj
)
&&
obj
[
0
]
===
+
obj
[
0
])
return
Math
.
min
.
apply
(
Math
,
obj
);
if
(
!
iterator
&&
_
.
isArray
(
obj
)
&&
obj
[
0
]
===
+
obj
[
0
]
&&
obj
.
length
<
65535
)
{
return
Math
.
min
.
apply
(
Math
,
obj
);
}
if
(
!
iterator
&&
_
.
isEmpty
(
obj
))
return
Infinity
;
if
(
!
iterator
&&
_
.
isEmpty
(
obj
))
return
Infinity
;
var
result
=
{
computed
:
Infinity
};
var
result
=
{
computed
:
Infinity
,
value
:
Infinity
};
each
(
obj
,
function
(
value
,
index
,
list
)
{
each
(
obj
,
function
(
value
,
index
,
list
)
{
var
computed
=
iterator
?
iterator
.
call
(
context
,
value
,
index
,
list
)
:
value
;
var
computed
=
iterator
?
iterator
.
call
(
context
,
value
,
index
,
list
)
:
value
;
computed
<
result
.
computed
&&
(
result
=
{
value
:
value
,
computed
:
computed
});
computed
<
result
.
computed
&&
(
result
=
{
value
:
value
,
computed
:
computed
});
...
@@ -248,51 +285,80 @@
...
@@ -248,51 +285,80 @@
// Shuffle an array.
// Shuffle an array.
_
.
shuffle
=
function
(
obj
)
{
_
.
shuffle
=
function
(
obj
)
{
var
shuffled
=
[],
rand
;
var
rand
;
each
(
obj
,
function
(
value
,
index
,
list
)
{
var
index
=
0
;
rand
=
Math
.
floor
(
Math
.
random
()
*
(
index
+
1
));
var
shuffled
=
[];
shuffled
[
index
]
=
shuffled
[
rand
];
each
(
obj
,
function
(
value
)
{
rand
=
_
.
random
(
index
++
);
shuffled
[
index
-
1
]
=
shuffled
[
rand
];
shuffled
[
rand
]
=
value
;
shuffled
[
rand
]
=
value
;
});
});
return
shuffled
;
return
shuffled
;
};
};
// An internal function to generate lookup iterators.
var
lookupIterator
=
function
(
value
)
{
return
_
.
isFunction
(
value
)
?
value
:
function
(
obj
){
return
obj
[
value
];
};
};
// Sort the object's values by a criterion produced by an iterator.
// Sort the object's values by a criterion produced by an iterator.
_
.
sortBy
=
function
(
obj
,
val
,
context
)
{
_
.
sortBy
=
function
(
obj
,
val
ue
,
context
)
{
var
iterator
=
_
.
isFunction
(
val
)
?
val
:
function
(
obj
)
{
return
obj
[
val
];
}
;
var
iterator
=
lookupIterator
(
value
)
;
return
_
.
pluck
(
_
.
map
(
obj
,
function
(
value
,
index
,
list
)
{
return
_
.
pluck
(
_
.
map
(
obj
,
function
(
value
,
index
,
list
)
{
return
{
return
{
value
:
value
,
value
:
value
,
index
:
index
,
criteria
:
iterator
.
call
(
context
,
value
,
index
,
list
)
criteria
:
iterator
.
call
(
context
,
value
,
index
,
list
)
};
};
}).
sort
(
function
(
left
,
right
)
{
}).
sort
(
function
(
left
,
right
)
{
var
a
=
left
.
criteria
,
b
=
right
.
criteria
;
var
a
=
left
.
criteria
;
if
(
a
===
void
0
)
return
1
;
var
b
=
right
.
criteria
;
if
(
b
===
void
0
)
return
-
1
;
if
(
a
!==
b
)
{
return
a
<
b
?
-
1
:
a
>
b
?
1
:
0
;
if
(
a
>
b
||
a
===
void
0
)
return
1
;
if
(
a
<
b
||
b
===
void
0
)
return
-
1
;
}
return
left
.
index
<
right
.
index
?
-
1
:
1
;
}),
'
value
'
);
}),
'
value
'
);
};
};
// Groups the object's values by a criterion. Pass either a string attribute
// An internal function used for aggregate "group by" operations.
// to group by, or a function that returns the criterion.
var
group
=
function
(
obj
,
value
,
context
,
behavior
)
{
_
.
groupBy
=
function
(
obj
,
val
)
{
var
result
=
{};
var
result
=
{};
var
iterator
=
_
.
isFunction
(
val
)
?
val
:
function
(
obj
)
{
return
obj
[
val
];
}
;
var
iterator
=
lookupIterator
(
value
||
_
.
identity
)
;
each
(
obj
,
function
(
value
,
index
)
{
each
(
obj
,
function
(
value
,
index
)
{
var
key
=
iterator
(
value
,
index
);
var
key
=
iterator
.
call
(
context
,
value
,
index
,
obj
);
(
result
[
key
]
||
(
result
[
key
]
=
[])).
push
(
value
);
behavior
(
result
,
key
,
value
);
});
});
return
result
;
return
result
;
};
};
// Use a comparator function to figure out at what index an object should
// Groups the object's values by a criterion. Pass either a string attribute
// be inserted so as to maintain order. Uses binary search.
// to group by, or a function that returns the criterion.
_
.
sortedIndex
=
function
(
array
,
obj
,
iterator
)
{
_
.
groupBy
=
function
(
obj
,
value
,
context
)
{
iterator
||
(
iterator
=
_
.
identity
);
return
group
(
obj
,
value
,
context
,
function
(
result
,
key
,
value
)
{
(
_
.
has
(
result
,
key
)
?
result
[
key
]
:
(
result
[
key
]
=
[])).
push
(
value
);
});
};
// Counts instances of an object that group by a certain criterion. Pass
// either a string attribute to count by, or a function that returns the
// criterion.
_
.
countBy
=
function
(
obj
,
value
,
context
)
{
return
group
(
obj
,
value
,
context
,
function
(
result
,
key
)
{
if
(
!
_
.
has
(
result
,
key
))
result
[
key
]
=
0
;
result
[
key
]
++
;
});
};
// Use a comparator function to figure out the smallest index at which
// an object should be inserted so as to maintain order. Uses binary search.
_
.
sortedIndex
=
function
(
array
,
obj
,
iterator
,
context
)
{
iterator
=
iterator
==
null
?
_
.
identity
:
lookupIterator
(
iterator
);
var
value
=
iterator
.
call
(
context
,
obj
);
var
low
=
0
,
high
=
array
.
length
;
var
low
=
0
,
high
=
array
.
length
;
while
(
low
<
high
)
{
while
(
low
<
high
)
{
var
mid
=
(
low
+
high
)
>>
1
;
var
mid
=
(
low
+
high
)
>>
>
1
;
iterator
(
array
[
mid
])
<
iterator
(
obj
)
?
low
=
mid
+
1
:
high
=
mid
;
iterator
.
call
(
context
,
array
[
mid
])
<
value
?
low
=
mid
+
1
:
high
=
mid
;
}
}
return
low
;
return
low
;
};
};
...
@@ -301,14 +367,14 @@
...
@@ -301,14 +367,14 @@
_
.
toArray
=
function
(
obj
)
{
_
.
toArray
=
function
(
obj
)
{
if
(
!
obj
)
return
[];
if
(
!
obj
)
return
[];
if
(
_
.
isArray
(
obj
))
return
slice
.
call
(
obj
);
if
(
_
.
isArray
(
obj
))
return
slice
.
call
(
obj
);
if
(
_
.
isArguments
(
obj
))
return
slice
.
call
(
obj
);
if
(
obj
.
length
===
+
obj
.
length
)
return
_
.
map
(
obj
,
_
.
identity
);
if
(
obj
.
toArray
&&
_
.
isFunction
(
obj
.
toArray
))
return
obj
.
toArray
();
return
_
.
values
(
obj
);
return
_
.
values
(
obj
);
};
};
// Return the number of elements in an object.
// Return the number of elements in an object.
_
.
size
=
function
(
obj
)
{
_
.
size
=
function
(
obj
)
{
return
_
.
isArray
(
obj
)
?
obj
.
length
:
_
.
keys
(
obj
).
length
;
if
(
obj
==
null
)
return
0
;
return
(
obj
.
length
===
+
obj
.
length
)
?
obj
.
length
:
_
.
keys
(
obj
).
length
;
};
};
// Array Functions
// Array Functions
...
@@ -318,10 +384,11 @@
...
@@ -318,10 +384,11 @@
// values in the array. Aliased as `head` and `take`. The **guard** check
// values in the array. Aliased as `head` and `take`. The **guard** check
// allows it to work with `_.map`.
// allows it to work with `_.map`.
_
.
first
=
_
.
head
=
_
.
take
=
function
(
array
,
n
,
guard
)
{
_
.
first
=
_
.
head
=
_
.
take
=
function
(
array
,
n
,
guard
)
{
if
(
array
==
null
)
return
void
0
;
return
(
n
!=
null
)
&&
!
guard
?
slice
.
call
(
array
,
0
,
n
)
:
array
[
0
];
return
(
n
!=
null
)
&&
!
guard
?
slice
.
call
(
array
,
0
,
n
)
:
array
[
0
];
};
};
// Returns everything but the last entry of the array. Espec
cia
ly useful on
// Returns everything but the last entry of the array. Espec
ial
ly useful on
// the arguments object. Passing **n** will return all the values in
// the arguments object. Passing **n** will return all the values in
// the array, excluding the last N. The **guard** check allows it to work with
// the array, excluding the last N. The **guard** check allows it to work with
// `_.map`.
// `_.map`.
...
@@ -332,6 +399,7 @@
...
@@ -332,6 +399,7 @@
// Get the last element of an array. Passing **n** will return the last N
// Get the last element of an array. Passing **n** will return the last N
// values in the array. The **guard** check allows it to work with `_.map`.
// values in the array. The **guard** check allows it to work with `_.map`.
_
.
last
=
function
(
array
,
n
,
guard
)
{
_
.
last
=
function
(
array
,
n
,
guard
)
{
if
(
array
==
null
)
return
void
0
;
if
((
n
!=
null
)
&&
!
guard
)
{
if
((
n
!=
null
)
&&
!
guard
)
{
return
slice
.
call
(
array
,
Math
.
max
(
array
.
length
-
n
,
0
));
return
slice
.
call
(
array
,
Math
.
max
(
array
.
length
-
n
,
0
));
}
else
{
}
else
{
...
@@ -339,26 +407,34 @@
...
@@ -339,26 +407,34 @@
}
}
};
};
// Returns everything but the first entry of the array. Aliased as `tail`.
// Returns everything but the first entry of the array. Aliased as `tail`
and `drop`
.
// Especially useful on the arguments object. Passing an **
index
** will return
// Especially useful on the arguments object. Passing an **
n
** will return
// the rest
of the values in the array from that index onward
. The **guard**
// the rest
N values in the array
. The **guard**
// check allows it to work with `_.map`.
// check allows it to work with `_.map`.
_
.
rest
=
_
.
tail
=
function
(
array
,
index
,
guard
)
{
_
.
rest
=
_
.
tail
=
_
.
drop
=
function
(
array
,
n
,
guard
)
{
return
slice
.
call
(
array
,
(
index
==
null
)
||
guard
?
1
:
index
);
return
slice
.
call
(
array
,
(
n
==
null
)
||
guard
?
1
:
n
);
};
};
// Trim out all falsy values from an array.
// Trim out all falsy values from an array.
_
.
compact
=
function
(
array
)
{
_
.
compact
=
function
(
array
)
{
return
_
.
filter
(
array
,
function
(
value
){
return
!!
value
;
});
return
_
.
filter
(
array
,
_
.
identity
);
};
// Internal implementation of a recursive `flatten` function.
var
flatten
=
function
(
input
,
shallow
,
output
)
{
each
(
input
,
function
(
value
)
{
if
(
_
.
isArray
(
value
))
{
shallow
?
push
.
apply
(
output
,
value
)
:
flatten
(
value
,
shallow
,
output
);
}
else
{
output
.
push
(
value
);
}
});
return
output
;
};
};
// Return a completely flattened version of an array.
// Return a completely flattened version of an array.
_
.
flatten
=
function
(
array
,
shallow
)
{
_
.
flatten
=
function
(
array
,
shallow
)
{
return
_
.
reduce
(
array
,
function
(
memo
,
value
)
{
return
flatten
(
array
,
shallow
,
[]);
if
(
_
.
isArray
(
value
))
return
memo
.
concat
(
shallow
?
value
:
_
.
flatten
(
value
));
memo
[
memo
.
length
]
=
value
;
return
memo
;
},
[]);
};
};
// Return a version of the array that does not contain the specified value(s).
// Return a version of the array that does not contain the specified value(s).
...
@@ -369,30 +445,33 @@
...
@@ -369,30 +445,33 @@
// Produce a duplicate-free version of the array. If the array has already
// Produce a duplicate-free version of the array. If the array has already
// been sorted, you have the option of using a faster algorithm.
// been sorted, you have the option of using a faster algorithm.
// Aliased as `unique`.
// Aliased as `unique`.
_
.
uniq
=
_
.
unique
=
function
(
array
,
isSorted
,
iterator
)
{
_
.
uniq
=
_
.
unique
=
function
(
array
,
isSorted
,
iterator
,
context
)
{
var
initial
=
iterator
?
_
.
map
(
array
,
iterator
)
:
array
;
if
(
_
.
isFunction
(
isSorted
))
{
context
=
iterator
;
iterator
=
isSorted
;
isSorted
=
false
;
}
var
initial
=
iterator
?
_
.
map
(
array
,
iterator
,
context
)
:
array
;
var
results
=
[];
var
results
=
[];
// The `isSorted` flag is irrelevant if the array only contains two elements.
var
seen
=
[];
if
(
array
.
length
<
3
)
isSorted
=
true
;
each
(
initial
,
function
(
value
,
index
)
{
_
.
reduce
(
initial
,
function
(
memo
,
value
,
index
)
{
if
(
isSorted
?
(
!
index
||
seen
[
seen
.
length
-
1
]
!==
value
)
:
!
_
.
contains
(
seen
,
value
))
{
if
(
isSorted
?
_
.
last
(
memo
)
!==
value
||
!
memo
.
length
:
!
_
.
include
(
memo
,
value
))
{
seen
.
push
(
value
);
memo
.
push
(
value
);
results
.
push
(
array
[
index
]);
results
.
push
(
array
[
index
]);
}
}
return
memo
;
});
},
[]);
return
results
;
return
results
;
};
};
// Produce an array that contains the union: each distinct element from all of
// Produce an array that contains the union: each distinct element from all of
// the passed-in arrays.
// the passed-in arrays.
_
.
union
=
function
()
{
_
.
union
=
function
()
{
return
_
.
uniq
(
_
.
flatten
(
arguments
,
true
));
return
_
.
uniq
(
concat
.
apply
(
ArrayProto
,
arguments
));
};
};
// Produce an array that contains every item shared between all the
// Produce an array that contains every item shared between all the
// passed-in arrays.
(Aliased as "intersect" for back-compat.)
// passed-in arrays.
_
.
intersection
=
_
.
intersect
=
function
(
array
)
{
_
.
intersection
=
function
(
array
)
{
var
rest
=
slice
.
call
(
arguments
,
1
);
var
rest
=
slice
.
call
(
arguments
,
1
);
return
_
.
filter
(
_
.
uniq
(
array
),
function
(
item
)
{
return
_
.
filter
(
_
.
uniq
(
array
),
function
(
item
)
{
return
_
.
every
(
rest
,
function
(
other
)
{
return
_
.
every
(
rest
,
function
(
other
)
{
...
@@ -404,8 +483,8 @@
...
@@ -404,8 +483,8 @@
// Take the difference between one array and a number of other arrays.
// Take the difference between one array and a number of other arrays.
// Only the elements present in just the first array will remain.
// Only the elements present in just the first array will remain.
_
.
difference
=
function
(
array
)
{
_
.
difference
=
function
(
array
)
{
var
rest
=
_
.
flatten
(
slice
.
call
(
arguments
,
1
),
true
);
var
rest
=
concat
.
apply
(
ArrayProto
,
slice
.
call
(
arguments
,
1
)
);
return
_
.
filter
(
array
,
function
(
value
){
return
!
_
.
include
(
rest
,
value
);
});
return
_
.
filter
(
array
,
function
(
value
){
return
!
_
.
contains
(
rest
,
value
);
});
};
};
// Zip together multiple lists into a single array -- elements that share
// Zip together multiple lists into a single array -- elements that share
...
@@ -414,10 +493,28 @@
...
@@ -414,10 +493,28 @@
var
args
=
slice
.
call
(
arguments
);
var
args
=
slice
.
call
(
arguments
);
var
length
=
_
.
max
(
_
.
pluck
(
args
,
'
length
'
));
var
length
=
_
.
max
(
_
.
pluck
(
args
,
'
length
'
));
var
results
=
new
Array
(
length
);
var
results
=
new
Array
(
length
);
for
(
var
i
=
0
;
i
<
length
;
i
++
)
results
[
i
]
=
_
.
pluck
(
args
,
""
+
i
);
for
(
var
i
=
0
;
i
<
length
;
i
++
)
{
results
[
i
]
=
_
.
pluck
(
args
,
""
+
i
);
}
return
results
;
return
results
;
};
};
// Converts lists into objects. Pass either a single array of `[key, value]`
// pairs, or two parallel arrays of the same length -- one of keys, and one of
// the corresponding values.
_
.
object
=
function
(
list
,
values
)
{
if
(
list
==
null
)
return
{};
var
result
=
{};
for
(
var
i
=
0
,
l
=
list
.
length
;
i
<
l
;
i
++
)
{
if
(
values
)
{
result
[
list
[
i
]]
=
values
[
i
];
}
else
{
result
[
list
[
i
][
0
]]
=
list
[
i
][
1
];
}
}
return
result
;
};
// If the browser doesn't supply us with indexOf (I'm looking at you, **MSIE**),
// If the browser doesn't supply us with indexOf (I'm looking at you, **MSIE**),
// we need this function. Return the position of the first occurrence of an
// we need this function. Return the position of the first occurrence of an
// item in an array, or -1 if the item is not included in the array.
// item in an array, or -1 if the item is not included in the array.
...
@@ -426,22 +523,29 @@
...
@@ -426,22 +523,29 @@
// for **isSorted** to use binary search.
// for **isSorted** to use binary search.
_
.
indexOf
=
function
(
array
,
item
,
isSorted
)
{
_
.
indexOf
=
function
(
array
,
item
,
isSorted
)
{
if
(
array
==
null
)
return
-
1
;
if
(
array
==
null
)
return
-
1
;
var
i
,
l
;
var
i
=
0
,
l
=
array
.
length
;
if
(
isSorted
)
{
if
(
isSorted
)
{
if
(
typeof
isSorted
==
'
number
'
)
{
i
=
(
isSorted
<
0
?
Math
.
max
(
0
,
l
+
isSorted
)
:
isSorted
);
}
else
{
i
=
_
.
sortedIndex
(
array
,
item
);
i
=
_
.
sortedIndex
(
array
,
item
);
return
array
[
i
]
===
item
?
i
:
-
1
;
return
array
[
i
]
===
item
?
i
:
-
1
;
}
}
if
(
nativeIndexOf
&&
array
.
indexOf
===
nativeIndexOf
)
return
array
.
indexOf
(
item
);
}
for
(
i
=
0
,
l
=
array
.
length
;
i
<
l
;
i
++
)
if
(
i
in
array
&&
array
[
i
]
===
item
)
return
i
;
if
(
nativeIndexOf
&&
array
.
indexOf
===
nativeIndexOf
)
return
array
.
indexOf
(
item
,
isSorted
);
for
(;
i
<
l
;
i
++
)
if
(
array
[
i
]
===
item
)
return
i
;
return
-
1
;
return
-
1
;
};
};
// Delegates to **ECMAScript 5**'s native `lastIndexOf` if available.
// Delegates to **ECMAScript 5**'s native `lastIndexOf` if available.
_
.
lastIndexOf
=
function
(
array
,
item
)
{
_
.
lastIndexOf
=
function
(
array
,
item
,
from
)
{
if
(
array
==
null
)
return
-
1
;
if
(
array
==
null
)
return
-
1
;
if
(
nativeLastIndexOf
&&
array
.
lastIndexOf
===
nativeLastIndexOf
)
return
array
.
lastIndexOf
(
item
);
var
hasIndex
=
from
!=
null
;
var
i
=
array
.
length
;
if
(
nativeLastIndexOf
&&
array
.
lastIndexOf
===
nativeLastIndexOf
)
{
while
(
i
--
)
if
(
i
in
array
&&
array
[
i
]
===
item
)
return
i
;
return
hasIndex
?
array
.
lastIndexOf
(
item
,
from
)
:
array
.
lastIndexOf
(
item
);
}
var
i
=
(
hasIndex
?
from
:
array
.
length
);
while
(
i
--
)
if
(
array
[
i
]
===
item
)
return
i
;
return
-
1
;
return
-
1
;
};
};
...
@@ -470,25 +574,23 @@
...
@@ -470,25 +574,23 @@
// Function (ahem) Functions
// Function (ahem) Functions
// ------------------
// ------------------
// Reusable constructor function for prototype setting.
var
ctor
=
function
(){};
// Create a function bound to a given object (assigning `this`, and arguments,
// Create a function bound to a given object (assigning `this`, and arguments,
// optionally). Binding with arguments is also known as `curry`.
// optionally). Delegates to **ECMAScript 5**'s native `Function.bind` if
// Delegates to **ECMAScript 5**'s native `Function.bind` if available.
// available.
// We check for `func.bind` first, to fail fast when `func` is undefined.
_
.
bind
=
function
(
func
,
context
)
{
_
.
bind
=
function
bind
(
func
,
context
)
{
var
bound
,
args
;
if
(
func
.
bind
===
nativeBind
&&
nativeBind
)
return
nativeBind
.
apply
(
func
,
slice
.
call
(
arguments
,
1
));
if
(
func
.
bind
===
nativeBind
&&
nativeBind
)
return
nativeBind
.
apply
(
func
,
slice
.
call
(
arguments
,
1
));
if
(
!
_
.
isFunction
(
func
))
throw
new
TypeError
;
var
args
=
slice
.
call
(
arguments
,
2
);
args
=
slice
.
call
(
arguments
,
2
);
return
function
()
{
return
bound
=
function
()
{
return
func
.
apply
(
context
,
args
.
concat
(
slice
.
call
(
arguments
)));
if
(
!
(
this
instanceof
bound
))
return
func
.
apply
(
context
,
args
.
concat
(
slice
.
call
(
arguments
)));
};
ctor
.
prototype
=
func
.
prototype
;
};
var
self
=
new
ctor
;
var
result
=
func
.
apply
(
self
,
args
.
concat
(
slice
.
call
(
arguments
)));
// Partially apply a function by creating a version that has had some of its
if
(
Object
(
result
)
===
result
)
return
result
;
// arguments pre-filled, without changing its dynamic `this` context.
return
self
;
_
.
partial
=
function
(
func
)
{
var
args
=
slice
.
call
(
arguments
,
1
);
return
function
()
{
return
func
.
apply
(
this
,
args
.
concat
(
slice
.
call
(
arguments
)));
};
};
};
};
...
@@ -496,7 +598,7 @@
...
@@ -496,7 +598,7 @@
// all callbacks defined on an object belong to it.
// all callbacks defined on an object belong to it.
_
.
bindAll
=
function
(
obj
)
{
_
.
bindAll
=
function
(
obj
)
{
var
funcs
=
slice
.
call
(
arguments
,
1
);
var
funcs
=
slice
.
call
(
arguments
,
1
);
if
(
funcs
.
length
==
0
)
funcs
=
_
.
functions
(
obj
);
if
(
funcs
.
length
==
=
0
)
funcs
=
_
.
functions
(
obj
);
each
(
funcs
,
function
(
f
)
{
obj
[
f
]
=
_
.
bind
(
obj
[
f
],
obj
);
});
each
(
funcs
,
function
(
f
)
{
obj
[
f
]
=
_
.
bind
(
obj
[
f
],
obj
);
});
return
obj
;
return
obj
;
};
};
...
@@ -527,23 +629,26 @@
...
@@ -527,23 +629,26 @@
// Returns a function, that, when invoked, will only be triggered at most once
// Returns a function, that, when invoked, will only be triggered at most once
// during a given window of time.
// during a given window of time.
_
.
throttle
=
function
(
func
,
wait
)
{
_
.
throttle
=
function
(
func
,
wait
)
{
var
context
,
args
,
timeout
,
throttling
,
more
,
result
;
var
context
,
args
,
timeout
,
result
;
var
whenDone
=
_
.
debounce
(
function
(){
more
=
throttling
=
false
;
},
wait
);
var
previous
=
0
;
return
function
()
{
context
=
this
;
args
=
arguments
;
var
later
=
function
()
{
var
later
=
function
()
{
previous
=
new
Date
;
timeout
=
null
;
timeout
=
null
;
if
(
more
)
func
.
apply
(
context
,
args
);
result
=
func
.
apply
(
context
,
args
);
whenDone
();
};
};
if
(
!
timeout
)
timeout
=
setTimeout
(
later
,
wait
);
return
function
()
{
if
(
throttling
)
{
var
now
=
new
Date
;
more
=
true
;
var
remaining
=
wait
-
(
now
-
previous
);
}
else
{
context
=
this
;
args
=
arguments
;
if
(
remaining
<=
0
)
{
clearTimeout
(
timeout
);
timeout
=
null
;
previous
=
now
;
result
=
func
.
apply
(
context
,
args
);
result
=
func
.
apply
(
context
,
args
);
}
else
if
(
!
timeout
)
{
timeout
=
setTimeout
(
later
,
remaining
);
}
}
whenDone
();
throttling
=
true
;
return
result
;
return
result
;
};
};
};
};
...
@@ -553,16 +658,18 @@
...
@@ -553,16 +658,18 @@
// N milliseconds. If `immediate` is passed, trigger the function on the
// N milliseconds. If `immediate` is passed, trigger the function on the
// leading edge, instead of the trailing.
// leading edge, instead of the trailing.
_
.
debounce
=
function
(
func
,
wait
,
immediate
)
{
_
.
debounce
=
function
(
func
,
wait
,
immediate
)
{
var
timeout
;
var
timeout
,
result
;
return
function
()
{
return
function
()
{
var
context
=
this
,
args
=
arguments
;
var
context
=
this
,
args
=
arguments
;
var
later
=
function
()
{
var
later
=
function
()
{
timeout
=
null
;
timeout
=
null
;
if
(
!
immediate
)
func
.
apply
(
context
,
args
);
if
(
!
immediate
)
result
=
func
.
apply
(
context
,
args
);
};
};
if
(
immediate
&&
!
timeout
)
func
.
apply
(
context
,
args
)
;
var
callNow
=
immediate
&&
!
timeout
;
clearTimeout
(
timeout
);
clearTimeout
(
timeout
);
timeout
=
setTimeout
(
later
,
wait
);
timeout
=
setTimeout
(
later
,
wait
);
if
(
callNow
)
result
=
func
.
apply
(
context
,
args
);
return
result
;
};
};
};
};
...
@@ -573,7 +680,9 @@
...
@@ -573,7 +680,9 @@
return
function
()
{
return
function
()
{
if
(
ran
)
return
memo
;
if
(
ran
)
return
memo
;
ran
=
true
;
ran
=
true
;
return
memo
=
func
.
apply
(
this
,
arguments
);
memo
=
func
.
apply
(
this
,
arguments
);
func
=
null
;
return
memo
;
};
};
};
};
...
@@ -582,7 +691,8 @@
...
@@ -582,7 +691,8 @@
// conditionally execute the original function.
// conditionally execute the original function.
_
.
wrap
=
function
(
func
,
wrapper
)
{
_
.
wrap
=
function
(
func
,
wrapper
)
{
return
function
()
{
return
function
()
{
var
args
=
[
func
].
concat
(
slice
.
call
(
arguments
,
0
));
var
args
=
[
func
];
push
.
apply
(
args
,
arguments
);
return
wrapper
.
apply
(
this
,
args
);
return
wrapper
.
apply
(
this
,
args
);
};
};
};
};
...
@@ -604,7 +714,9 @@
...
@@ -604,7 +714,9 @@
_
.
after
=
function
(
times
,
func
)
{
_
.
after
=
function
(
times
,
func
)
{
if
(
times
<=
0
)
return
func
();
if
(
times
<=
0
)
return
func
();
return
function
()
{
return
function
()
{
if
(
--
times
<
1
)
{
return
func
.
apply
(
this
,
arguments
);
}
if
(
--
times
<
1
)
{
return
func
.
apply
(
this
,
arguments
);
}
};
};
};
};
...
@@ -622,7 +734,23 @@
...
@@ -622,7 +734,23 @@
// Retrieve the values of an object's properties.
// Retrieve the values of an object's properties.
_
.
values
=
function
(
obj
)
{
_
.
values
=
function
(
obj
)
{
return
_
.
map
(
obj
,
_
.
identity
);
var
values
=
[];
for
(
var
key
in
obj
)
if
(
_
.
has
(
obj
,
key
))
values
.
push
(
obj
[
key
]);
return
values
;
};
// Convert an object into a list of `[key, value]` pairs.
_
.
pairs
=
function
(
obj
)
{
var
pairs
=
[];
for
(
var
key
in
obj
)
if
(
_
.
has
(
obj
,
key
))
pairs
.
push
([
key
,
obj
[
key
]]);
return
pairs
;
};
// Invert the keys and values of an object. The values must be serializable.
_
.
invert
=
function
(
obj
)
{
var
result
=
{};
for
(
var
key
in
obj
)
if
(
_
.
has
(
obj
,
key
))
result
[
obj
[
key
]]
=
key
;
return
result
;
};
};
// Return a sorted list of the function names available on the object.
// Return a sorted list of the function names available on the object.
...
@@ -638,28 +766,43 @@
...
@@ -638,28 +766,43 @@
// Extend a given object with all the properties in passed-in object(s).
// Extend a given object with all the properties in passed-in object(s).
_
.
extend
=
function
(
obj
)
{
_
.
extend
=
function
(
obj
)
{
each
(
slice
.
call
(
arguments
,
1
),
function
(
source
)
{
each
(
slice
.
call
(
arguments
,
1
),
function
(
source
)
{
if
(
source
)
{
for
(
var
prop
in
source
)
{
for
(
var
prop
in
source
)
{
obj
[
prop
]
=
source
[
prop
];
obj
[
prop
]
=
source
[
prop
];
}
}
}
});
});
return
obj
;
return
obj
;
};
};
// Return a copy of the object only containing the whitelisted properties.
// Return a copy of the object only containing the whitelisted properties.
_
.
pick
=
function
(
obj
)
{
_
.
pick
=
function
(
obj
)
{
var
result
=
{};
var
copy
=
{};
each
(
_
.
flatten
(
slice
.
call
(
arguments
,
1
)),
function
(
key
)
{
var
keys
=
concat
.
apply
(
ArrayProto
,
slice
.
call
(
arguments
,
1
));
if
(
key
in
obj
)
result
[
key
]
=
obj
[
key
];
each
(
keys
,
function
(
key
)
{
if
(
key
in
obj
)
copy
[
key
]
=
obj
[
key
];
});
});
return
result
;
return
copy
;
};
// Return a copy of the object without the blacklisted properties.
_
.
omit
=
function
(
obj
)
{
var
copy
=
{};
var
keys
=
concat
.
apply
(
ArrayProto
,
slice
.
call
(
arguments
,
1
));
for
(
var
key
in
obj
)
{
if
(
!
_
.
contains
(
keys
,
key
))
copy
[
key
]
=
obj
[
key
];
}
return
copy
;
};
};
// Fill in a given object with default properties.
// Fill in a given object with default properties.
_
.
defaults
=
function
(
obj
)
{
_
.
defaults
=
function
(
obj
)
{
each
(
slice
.
call
(
arguments
,
1
),
function
(
source
)
{
each
(
slice
.
call
(
arguments
,
1
),
function
(
source
)
{
if
(
source
)
{
for
(
var
prop
in
source
)
{
for
(
var
prop
in
source
)
{
if
(
obj
[
prop
]
==
null
)
obj
[
prop
]
=
source
[
prop
];
if
(
obj
[
prop
]
==
null
)
obj
[
prop
]
=
source
[
prop
];
}
}
}
});
});
return
obj
;
return
obj
;
};
};
...
@@ -678,19 +821,16 @@
...
@@ -678,19 +821,16 @@
return
obj
;
return
obj
;
};
};
// Internal recursive comparison function.
// Internal recursive comparison function
for `isEqual`
.
function
eq
(
a
,
b
,
s
tack
)
{
var
eq
=
function
(
a
,
b
,
aStack
,
bS
tack
)
{
// Identical objects are equal. `0 === -0`, but they aren't identical.
// Identical objects are equal. `0 === -0`, but they aren't identical.
// See the Harmony `egal` proposal: http://wiki.ecmascript.org/doku.php?id=harmony:egal.
// See the Harmony `egal` proposal: http://wiki.ecmascript.org/doku.php?id=harmony:egal.
if
(
a
===
b
)
return
a
!==
0
||
1
/
a
==
1
/
b
;
if
(
a
===
b
)
return
a
!==
0
||
1
/
a
==
1
/
b
;
// A strict comparison is necessary because `null == undefined`.
// A strict comparison is necessary because `null == undefined`.
if
(
a
==
null
||
b
==
null
)
return
a
===
b
;
if
(
a
==
null
||
b
==
null
)
return
a
===
b
;
// Unwrap any wrapped objects.
// Unwrap any wrapped objects.
if
(
a
.
_chain
)
a
=
a
.
_wrapped
;
if
(
a
instanceof
_
)
a
=
a
.
_wrapped
;
if
(
b
.
_chain
)
b
=
b
.
_wrapped
;
if
(
b
instanceof
_
)
b
=
b
.
_wrapped
;
// Invoke a custom `isEqual` method if one is provided.
if
(
a
.
isEqual
&&
_
.
isFunction
(
a
.
isEqual
))
return
a
.
isEqual
(
b
);
if
(
b
.
isEqual
&&
_
.
isFunction
(
b
.
isEqual
))
return
b
.
isEqual
(
a
);
// Compare `[[Class]]` names.
// Compare `[[Class]]` names.
var
className
=
toString
.
call
(
a
);
var
className
=
toString
.
call
(
a
);
if
(
className
!=
toString
.
call
(
b
))
return
false
;
if
(
className
!=
toString
.
call
(
b
))
return
false
;
...
@@ -720,14 +860,15 @@
...
@@ -720,14 +860,15 @@
if
(
typeof
a
!=
'
object
'
||
typeof
b
!=
'
object
'
)
return
false
;
if
(
typeof
a
!=
'
object
'
||
typeof
b
!=
'
object
'
)
return
false
;
// Assume equality for cyclic structures. The algorithm for detecting cyclic
// Assume equality for cyclic structures. The algorithm for detecting cyclic
// structures is adapted from ES 5.1 section 15.12.3, abstract operation `JO`.
// structures is adapted from ES 5.1 section 15.12.3, abstract operation `JO`.
var
length
=
s
tack
.
length
;
var
length
=
aS
tack
.
length
;
while
(
length
--
)
{
while
(
length
--
)
{
// Linear search. Performance is inversely proportional to the number of
// Linear search. Performance is inversely proportional to the number of
// unique nested structures.
// unique nested structures.
if
(
stack
[
length
]
==
a
)
return
true
;
if
(
aStack
[
length
]
==
a
)
return
bStack
[
length
]
==
b
;
}
}
// Add the first object to the stack of traversed objects.
// Add the first object to the stack of traversed objects.
stack
.
push
(
a
);
aStack
.
push
(
a
);
bStack
.
push
(
b
);
var
size
=
0
,
result
=
true
;
var
size
=
0
,
result
=
true
;
// Recursively compare objects and arrays.
// Recursively compare objects and arrays.
if
(
className
==
'
[object Array]
'
)
{
if
(
className
==
'
[object Array]
'
)
{
...
@@ -737,20 +878,24 @@
...
@@ -737,20 +878,24 @@
if
(
result
)
{
if
(
result
)
{
// Deep compare the contents, ignoring non-numeric properties.
// Deep compare the contents, ignoring non-numeric properties.
while
(
size
--
)
{
while
(
size
--
)
{
// Ensure commutative equality for sparse arrays.
if
(
!
(
result
=
eq
(
a
[
size
],
b
[
size
],
aStack
,
bStack
)))
break
;
if
(
!
(
result
=
size
in
a
==
size
in
b
&&
eq
(
a
[
size
],
b
[
size
],
stack
)))
break
;
}
}
}
}
}
else
{
}
else
{
// Objects with different constructors are not equivalent.
// Objects with different constructors are not equivalent, but `Object`s
if
(
'
constructor
'
in
a
!=
'
constructor
'
in
b
||
a
.
constructor
!=
b
.
constructor
)
return
false
;
// from different frames are.
var
aCtor
=
a
.
constructor
,
bCtor
=
b
.
constructor
;
if
(
aCtor
!==
bCtor
&&
!
(
_
.
isFunction
(
aCtor
)
&&
(
aCtor
instanceof
aCtor
)
&&
_
.
isFunction
(
bCtor
)
&&
(
bCtor
instanceof
bCtor
)))
{
return
false
;
}
// Deep compare objects.
// Deep compare objects.
for
(
var
key
in
a
)
{
for
(
var
key
in
a
)
{
if
(
_
.
has
(
a
,
key
))
{
if
(
_
.
has
(
a
,
key
))
{
// Count the expected number of properties.
// Count the expected number of properties.
size
++
;
size
++
;
// Deep compare each member.
// Deep compare each member.
if
(
!
(
result
=
_
.
has
(
b
,
key
)
&&
eq
(
a
[
key
],
b
[
key
],
s
tack
)))
break
;
if
(
!
(
result
=
_
.
has
(
b
,
key
)
&&
eq
(
a
[
key
],
b
[
key
],
aStack
,
bS
tack
)))
break
;
}
}
}
}
// Ensure that both objects contain the same number of properties.
// Ensure that both objects contain the same number of properties.
...
@@ -762,13 +907,14 @@
...
@@ -762,13 +907,14 @@
}
}
}
}
// Remove the first object from the stack of traversed objects.
// Remove the first object from the stack of traversed objects.
stack
.
pop
();
aStack
.
pop
();
bStack
.
pop
();
return
result
;
return
result
;
}
}
;
// Perform a deep comparison to check if two objects are equal.
// Perform a deep comparison to check if two objects are equal.
_
.
isEqual
=
function
(
a
,
b
)
{
_
.
isEqual
=
function
(
a
,
b
)
{
return
eq
(
a
,
b
,
[]);
return
eq
(
a
,
b
,
[]
,
[]
);
};
};
// Is a given array, string, or object empty?
// Is a given array, string, or object empty?
...
@@ -782,7 +928,7 @@
...
@@ -782,7 +928,7 @@
// Is a given value a DOM element?
// Is a given value a DOM element?
_
.
isElement
=
function
(
obj
)
{
_
.
isElement
=
function
(
obj
)
{
return
!!
(
obj
&&
obj
.
nodeType
==
1
);
return
!!
(
obj
&&
obj
.
nodeType
==
=
1
);
};
};
// Is a given value an array?
// Is a given value an array?
...
@@ -796,40 +942,36 @@
...
@@ -796,40 +942,36 @@
return
obj
===
Object
(
obj
);
return
obj
===
Object
(
obj
);
};
};
// Is a given variable an arguments object?
// Add some isType methods: isArguments, isFunction, isString, isNumber, isDate, isRegExp.
_
.
isArguments
=
function
(
obj
)
{
each
([
'
Arguments
'
,
'
Function
'
,
'
String
'
,
'
Number
'
,
'
Date
'
,
'
RegExp
'
],
function
(
name
)
{
return
toString
.
call
(
obj
)
==
'
[object Arguments]
'
;
_
[
'
is
'
+
name
]
=
function
(
obj
)
{
return
toString
.
call
(
obj
)
==
'
[object
'
+
name
+
'
]
'
;
};
};
});
// Define a fallback version of the method in browsers (ahem, IE), where
// there isn't any inspectable "Arguments" type.
if
(
!
_
.
isArguments
(
arguments
))
{
if
(
!
_
.
isArguments
(
arguments
))
{
_
.
isArguments
=
function
(
obj
)
{
_
.
isArguments
=
function
(
obj
)
{
return
!!
(
obj
&&
_
.
has
(
obj
,
'
callee
'
));
return
!!
(
obj
&&
_
.
has
(
obj
,
'
callee
'
));
};
};
}
}
// Is a given value a function?
// Optimize `isFunction` if appropriate.
if
(
typeof
(
/./
)
!==
'
function
'
)
{
_
.
isFunction
=
function
(
obj
)
{
_
.
isFunction
=
function
(
obj
)
{
return
toString
.
call
(
obj
)
==
'
[object Function]
'
;
return
typeof
obj
===
'
function
'
;
};
// Is a given value a string?
_
.
isString
=
function
(
obj
)
{
return
toString
.
call
(
obj
)
==
'
[object String]
'
;
};
// Is a given value a number?
_
.
isNumber
=
function
(
obj
)
{
return
toString
.
call
(
obj
)
==
'
[object Number]
'
;
};
};
}
// Is a given object a finite number?
// Is a given object a finite number?
_
.
isFinite
=
function
(
obj
)
{
_
.
isFinite
=
function
(
obj
)
{
return
_
.
isNumber
(
obj
)
&&
isFinite
(
obj
);
return
isFinite
(
obj
)
&&
!
isNaN
(
parseFloat
(
obj
)
);
};
};
// Is the given value `NaN`?
// Is the given value `NaN`?
(NaN is the only number which does not equal itself).
_
.
isNaN
=
function
(
obj
)
{
_
.
isNaN
=
function
(
obj
)
{
// `NaN` is the only value for which `===` is not reflexive.
return
_
.
isNumber
(
obj
)
&&
obj
!=
+
obj
;
return
obj
!==
obj
;
};
};
// Is a given value a boolean?
// Is a given value a boolean?
...
@@ -837,16 +979,6 @@
...
@@ -837,16 +979,6 @@
return
obj
===
true
||
obj
===
false
||
toString
.
call
(
obj
)
==
'
[object Boolean]
'
;
return
obj
===
true
||
obj
===
false
||
toString
.
call
(
obj
)
==
'
[object Boolean]
'
;
};
};
// Is a given value a date?
_
.
isDate
=
function
(
obj
)
{
return
toString
.
call
(
obj
)
==
'
[object Date]
'
;
};
// Is the given value a regular expression?
_
.
isRegExp
=
function
(
obj
)
{
return
toString
.
call
(
obj
)
==
'
[object RegExp]
'
;
};
// Is a given value equal to null?
// Is a given value equal to null?
_
.
isNull
=
function
(
obj
)
{
_
.
isNull
=
function
(
obj
)
{
return
obj
===
null
;
return
obj
===
null
;
...
@@ -857,7 +989,8 @@
...
@@ -857,7 +989,8 @@
return
obj
===
void
0
;
return
obj
===
void
0
;
};
};
// Has own property?
// Shortcut function for checking if an object has a given property directly
// on itself (in other words, not on a prototype).
_
.
has
=
function
(
obj
,
key
)
{
_
.
has
=
function
(
obj
,
key
)
{
return
hasOwnProperty
.
call
(
obj
,
key
);
return
hasOwnProperty
.
call
(
obj
,
key
);
};
};
...
@@ -878,14 +1011,49 @@
...
@@ -878,14 +1011,49 @@
};
};
// Run a function **n** times.
// Run a function **n** times.
_
.
times
=
function
(
n
,
iterator
,
context
)
{
_
.
times
=
function
(
n
,
iterator
,
context
)
{
for
(
var
i
=
0
;
i
<
n
;
i
++
)
iterator
.
call
(
context
,
i
);
var
accum
=
Array
(
n
);
for
(
var
i
=
0
;
i
<
n
;
i
++
)
accum
[
i
]
=
iterator
.
call
(
context
,
i
);
return
accum
;
};
};
// Escape a string for HTML interpolation.
// Return a random integer between min and max (inclusive).
_
.
escape
=
function
(
string
)
{
_
.
random
=
function
(
min
,
max
)
{
return
(
''
+
string
).
replace
(
/&/g
,
'
&
'
).
replace
(
/</g
,
'
<
'
).
replace
(
/>/g
,
'
>
'
).
replace
(
/"/g
,
'
"
'
).
replace
(
/'/g
,
'
'
'
).
replace
(
/
\/
/g
,
'
/
'
);
if
(
max
==
null
)
{
max
=
min
;
min
=
0
;
}
return
min
+
Math
.
floor
(
Math
.
random
()
*
(
max
-
min
+
1
));
};
// List of HTML entities for escaping.
var
entityMap
=
{
escape
:
{
'
&
'
:
'
&
'
,
'
<
'
:
'
<
'
,
'
>
'
:
'
>
'
,
'
"
'
:
'
"
'
,
"
'
"
:
'
'
'
,
'
/
'
:
'
/
'
}
};
};
entityMap
.
unescape
=
_
.
invert
(
entityMap
.
escape
);
// Regexes containing the keys and values listed immediately above.
var
entityRegexes
=
{
escape
:
new
RegExp
(
'
[
'
+
_
.
keys
(
entityMap
.
escape
).
join
(
''
)
+
'
]
'
,
'
g
'
),
unescape
:
new
RegExp
(
'
(
'
+
_
.
keys
(
entityMap
.
unescape
).
join
(
'
|
'
)
+
'
)
'
,
'
g
'
)
};
// Functions for escaping and unescaping strings to/from HTML interpolation.
_
.
each
([
'
escape
'
,
'
unescape
'
],
function
(
method
)
{
_
[
method
]
=
function
(
string
)
{
if
(
string
==
null
)
return
''
;
return
(
''
+
string
).
replace
(
entityRegexes
[
method
],
function
(
match
)
{
return
entityMap
[
method
][
match
];
});
};
});
// If the value of the named property is a function then invoke it;
// If the value of the named property is a function then invoke it;
// otherwise, return it.
// otherwise, return it.
...
@@ -895,11 +1063,15 @@
...
@@ -895,11 +1063,15 @@
return
_
.
isFunction
(
value
)
?
value
.
call
(
object
)
:
value
;
return
_
.
isFunction
(
value
)
?
value
.
call
(
object
)
:
value
;
};
};
// Add your own custom functions to the Underscore object, ensuring that
// Add your own custom functions to the Underscore object.
// they're correctly added to the OOP wrapper as well.
_
.
mixin
=
function
(
obj
)
{
_
.
mixin
=
function
(
obj
)
{
each
(
_
.
functions
(
obj
),
function
(
name
){
each
(
_
.
functions
(
obj
),
function
(
name
){
addToWrapper
(
name
,
_
[
name
]
=
obj
[
name
]);
var
func
=
_
[
name
]
=
obj
[
name
];
_
.
prototype
[
name
]
=
function
()
{
var
args
=
[
this
.
_wrapped
];
push
.
apply
(
args
,
arguments
);
return
result
.
call
(
this
,
func
.
apply
(
_
,
args
));
};
});
});
};
};
...
@@ -907,7 +1079,7 @@
...
@@ -907,7 +1079,7 @@
// Useful for temporary DOM ids.
// Useful for temporary DOM ids.
var
idCounter
=
0
;
var
idCounter
=
0
;
_
.
uniqueId
=
function
(
prefix
)
{
_
.
uniqueId
=
function
(
prefix
)
{
var
id
=
idCounter
++
;
var
id
=
++
idCounter
+
''
;
return
prefix
?
prefix
+
id
:
id
;
return
prefix
?
prefix
+
id
:
id
;
};
};
...
@@ -922,72 +1094,78 @@
...
@@ -922,72 +1094,78 @@
// When customizing `templateSettings`, if you don't want to define an
// When customizing `templateSettings`, if you don't want to define an
// interpolation, evaluation or escaping regex, we need one that is
// interpolation, evaluation or escaping regex, we need one that is
// guaranteed not to match.
// guaranteed not to match.
var
noMatch
=
/
.
^/
;
var
noMatch
=
/
(
.
)
^/
;
// Certain characters need to be escaped so that they can be put into a
// Certain characters need to be escaped so that they can be put into a
// string literal.
// string literal.
var
escapes
=
{
var
escapes
=
{
'
\\
'
:
'
\\
'
,
"
'
"
:
"
'
"
,
"
'
"
:
"
'
"
,
'
r
'
:
'
\r
'
,
'
\\
'
:
'
\\
'
,
'
n
'
:
'
\n
'
,
'
\r
'
:
'
r
'
,
'
t
'
:
'
\t
'
,
'
\n
'
:
'
n
'
,
'
u2028
'
:
'
\
u2028
'
,
'
\t
'
:
'
t
'
,
'
u2029
'
:
'
\
u2029
'
'
\
u2028
'
:
'
u2028
'
,
'
\
u2029
'
:
'
u2029
'
};
};
for
(
var
p
in
escapes
)
escapes
[
escapes
[
p
]]
=
p
;
var
escaper
=
/
\\
|'|
\r
|
\n
|
\t
|
\u
2028|
\u
2029/g
;
var
escaper
=
/
\\
|'|
\r
|
\n
|
\t
|
\u
2028|
\u
2029/g
;
var
unescaper
=
/
\\(\\
|'|r|n|t|u2028|u2029
)
/g
;
// Within an interpolation, evaluation, or escaping, remove HTML escaping
// that had been previously added.
var
unescape
=
function
(
code
)
{
return
code
.
replace
(
unescaper
,
function
(
match
,
escape
)
{
return
escapes
[
escape
];
});
};
// JavaScript micro-templating, similar to John Resig's implementation.
// JavaScript micro-templating, similar to John Resig's implementation.
// Underscore templating handles arbitrary delimiters, preserves whitespace,
// Underscore templating handles arbitrary delimiters, preserves whitespace,
// and correctly escapes quotes within interpolated code.
// and correctly escapes quotes within interpolated code.
_
.
template
=
function
(
text
,
data
,
settings
)
{
_
.
template
=
function
(
text
,
data
,
settings
)
{
settings
=
_
.
defaults
(
settings
||
{},
_
.
templateSettings
);
var
render
;
settings
=
_
.
defaults
({},
settings
,
_
.
templateSettings
);
// Compile the template source, taking care to escape characters that
// cannot be included in a string literal and then unescape them in code
// Combine delimiters into one regular expression via alternation.
// blocks.
var
matcher
=
new
RegExp
([
var
source
=
"
__p+='
"
+
text
(
settings
.
escape
||
noMatch
).
source
,
.
replace
(
escaper
,
function
(
match
)
{
(
settings
.
interpolate
||
noMatch
).
source
,
return
'
\\
'
+
escapes
[
match
];
(
settings
.
evaluate
||
noMatch
).
source
})
].
join
(
'
|
'
)
+
'
|$
'
,
'
g
'
);
.
replace
(
settings
.
escape
||
noMatch
,
function
(
match
,
code
)
{
return
"
'+
\n
_.escape(
"
+
unescape
(
code
)
+
"
)+
\n
'
"
;
// Compile the template source, escaping string literals appropriately.
})
var
index
=
0
;
.
replace
(
settings
.
interpolate
||
noMatch
,
function
(
match
,
code
)
{
var
source
=
"
__p+='
"
;
return
"
'+
\n
(
"
+
unescape
(
code
)
+
"
)+
\n
'
"
;
text
.
replace
(
matcher
,
function
(
match
,
escape
,
interpolate
,
evaluate
,
offset
)
{
})
source
+=
text
.
slice
(
index
,
offset
)
.
replace
(
settings
.
evaluate
||
noMatch
,
function
(
match
,
code
)
{
.
replace
(
escaper
,
function
(
match
)
{
return
'
\\
'
+
escapes
[
match
];
});
return
"
';
\n
"
+
unescape
(
code
)
+
"
\n
;__p+='
"
;
})
+
"
';
\n
"
;
if
(
escape
)
{
source
+=
"
'+
\n
((__t=(
"
+
escape
+
"
))==null?'':_.escape(__t))+
\n
'
"
;
}
if
(
interpolate
)
{
source
+=
"
'+
\n
((__t=(
"
+
interpolate
+
"
))==null?'':__t)+
\n
'
"
;
}
if
(
evaluate
)
{
source
+=
"
';
\n
"
+
evaluate
+
"
\n
__p+='
"
;
}
index
=
offset
+
match
.
length
;
return
match
;
});
source
+=
"
';
\n
"
;
// If a variable is not specified, place data values in local scope.
// If a variable is not specified, place data values in local scope.
if
(
!
settings
.
variable
)
source
=
'
with(obj||{}){
\n
'
+
source
+
'
}
\n
'
;
if
(
!
settings
.
variable
)
source
=
'
with(obj||{}){
\n
'
+
source
+
'
}
\n
'
;
source
=
"
var __
p='';
"
+
source
=
"
var __
t,__p='',__j=Array.prototype.join,
"
+
"
var print=function(){__p+=Array.prototype.join.call(arguments, '')
};
\n
"
+
"
print=function(){__p+=__j.call(arguments,'');
};
\n
"
+
source
+
"
return __p;
\n
"
;
source
+
"
return __p;
\n
"
;
var
render
=
new
Function
(
settings
.
variable
||
'
obj
'
,
'
_
'
,
source
);
try
{
render
=
new
Function
(
settings
.
variable
||
'
obj
'
,
'
_
'
,
source
);
}
catch
(
e
)
{
e
.
source
=
source
;
throw
e
;
}
if
(
data
)
return
render
(
data
,
_
);
if
(
data
)
return
render
(
data
,
_
);
var
template
=
function
(
data
)
{
var
template
=
function
(
data
)
{
return
render
.
call
(
this
,
data
,
_
);
return
render
.
call
(
this
,
data
,
_
);
};
};
// Provide the compiled function source as a convenience for build time
// Provide the compiled function source as a convenience for precompilation.
// precompilation.
template
.
source
=
'
function(
'
+
(
settings
.
variable
||
'
obj
'
)
+
'
){
\n
'
+
source
+
'
}
'
;
template
.
source
=
'
function(
'
+
(
settings
.
variable
||
'
obj
'
)
+
'
){
\n
'
+
source
+
'
}
'
;
return
template
;
return
template
;
};
};
...
@@ -997,29 +1175,15 @@
...
@@ -997,29 +1175,15 @@
return
_
(
obj
).
chain
();
return
_
(
obj
).
chain
();
};
};
//
The OOP Wrapper
//
OOP
// ---------------
// ---------------
// If Underscore is called as a function, it returns a wrapped object that
// If Underscore is called as a function, it returns a wrapped object that
// can be used OO-style. This wrapper holds altered versions of all the
// can be used OO-style. This wrapper holds altered versions of all the
// underscore functions. Wrapped objects may be chained.
// underscore functions. Wrapped objects may be chained.
var
wrapper
=
function
(
obj
)
{
this
.
_wrapped
=
obj
;
};
// Expose `wrapper.prototype` as `_.prototype`
_
.
prototype
=
wrapper
.
prototype
;
// Helper function to continue chaining intermediate results.
// Helper function to continue chaining intermediate results.
var
result
=
function
(
obj
,
chain
)
{
var
result
=
function
(
obj
)
{
return
chain
?
_
(
obj
).
chain
()
:
obj
;
return
this
.
_chain
?
_
(
obj
).
chain
()
:
obj
;
};
// A method to easily add functions to the OOP wrapper.
var
addToWrapper
=
function
(
name
,
func
)
{
wrapper
.
prototype
[
name
]
=
function
()
{
var
args
=
slice
.
call
(
arguments
);
unshift
.
call
(
args
,
this
.
_wrapped
);
return
result
(
func
.
apply
(
_
,
args
),
this
.
_chain
);
};
};
};
// Add all of the Underscore functions to the wrapper object.
// Add all of the Underscore functions to the wrapper object.
...
@@ -1028,32 +1192,35 @@
...
@@ -1028,32 +1192,35 @@
// Add all mutator Array functions to the wrapper.
// Add all mutator Array functions to the wrapper.
each
([
'
pop
'
,
'
push
'
,
'
reverse
'
,
'
shift
'
,
'
sort
'
,
'
splice
'
,
'
unshift
'
],
function
(
name
)
{
each
([
'
pop
'
,
'
push
'
,
'
reverse
'
,
'
shift
'
,
'
sort
'
,
'
splice
'
,
'
unshift
'
],
function
(
name
)
{
var
method
=
ArrayProto
[
name
];
var
method
=
ArrayProto
[
name
];
wrapper
.
prototype
[
name
]
=
function
()
{
_
.
prototype
[
name
]
=
function
()
{
var
wrapped
=
this
.
_wrapped
;
var
obj
=
this
.
_wrapped
;
method
.
apply
(
wrapped
,
arguments
);
method
.
apply
(
obj
,
arguments
);
var
length
=
wrapped
.
length
;
if
((
name
==
'
shift
'
||
name
==
'
splice
'
)
&&
obj
.
length
===
0
)
delete
obj
[
0
];
if
((
name
==
'
shift
'
||
name
==
'
splice
'
)
&&
length
===
0
)
delete
wrapped
[
0
];
return
result
.
call
(
this
,
obj
);
return
result
(
wrapped
,
this
.
_chain
);
};
};
});
});
// Add all accessor Array functions to the wrapper.
// Add all accessor Array functions to the wrapper.
each
([
'
concat
'
,
'
join
'
,
'
slice
'
],
function
(
name
)
{
each
([
'
concat
'
,
'
join
'
,
'
slice
'
],
function
(
name
)
{
var
method
=
ArrayProto
[
name
];
var
method
=
ArrayProto
[
name
];
wrapper
.
prototype
[
name
]
=
function
()
{
_
.
prototype
[
name
]
=
function
()
{
return
result
(
method
.
apply
(
this
.
_wrapped
,
arguments
),
this
.
_chain
);
return
result
.
call
(
this
,
method
.
apply
(
this
.
_wrapped
,
arguments
)
);
};
};
});
});
_
.
extend
(
_
.
prototype
,
{
// Start chaining a wrapped Underscore object.
// Start chaining a wrapped Underscore object.
wrapper
.
prototype
.
chain
=
function
()
{
chain
:
function
()
{
this
.
_chain
=
true
;
this
.
_chain
=
true
;
return
this
;
return
this
;
};
},
// Extracts the result from a wrapped and chained object.
// Extracts the result from a wrapped and chained object.
wrapper
.
prototype
.
value
=
function
()
{
value
:
function
()
{
return
this
.
_wrapped
;
return
this
.
_wrapped
;
};
}
});
}).
call
(
this
);
}).
call
(
this
);
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment