List.filter method

Returns the elements of a list that meet the condition specified in a callback function.
Syntax
var array = list.filter(callback, thisArg);
Parameters
- callback
-
Type: Function
A function that accepts up to three arguments. The function is called for each element in the list.
This function must always return the same results, given the same inputs. The results should not depend on values that are subject to change. You must call notifyMutated each time an item changes. Do not batch change notifications.
- thisArg
-
Type: Object
An object to which the this keyword can refer in the callback function. If thisArg is omitted, undefined is used.
Return value
Type: Array
An array containing the elements that meet the condition specified in the callback function.
Examples
The following code shows how to use this method. The filter function selects only strings that have even-numbered lengths.
var stringArr = [];
stringArr.push("abc");
stringArr.push("abcd");
stringArr.push("abcde");
stringArr.push("abcdef");
var stringList = new WinJS.Binding.List(stringArr);
var filterArr = stringList.filter(filterStrings);
console.log(filterArr.join());
function filterStrings(str) {
if (str.length % 2 == 0)
return true;
else
return false;
}
// Output:
// abcd,abcdef
Requirements
|
Minimum WinJS version |
WinJS 1.0 |
|---|---|
|
Namespace |
WinJS.Binding |
See also