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: FunctionA 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: ObjectAn 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 |