filter method

List.filter method

Applies to Windows and Windows Phone

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

List

 

 

Show:
© 2017 Microsoft