---
title: "filter(predicate)"
layout: default
section: api
---

__Description__ : Filter nested files/folders with the specified function.

__Arguments__

name      | type     | description
----------|----------|------------
predicate | function | the predicate to use.

The predicate has the following signature : `function (relativePath, file) {...}` :

name         | type      | description
-------------|-----------|------------
relativePath | string    | the filename and its path, reliatively to the current folder.
file         | ZipObject | the file being tested. See [ZipObject]({{site.baseurl}}/documentation/api_zipobject.html).

The predicate must return true if the file should be included, false otherwise.


__Returns__ : An array of matching ZipObject.

__Throws__ : Nothing.

<!-- __Complexity__ : **O(k)** where k is the number of entries. -->

__Example__

```js
var zip = new JSZip().folder("dir");
zip.file("readme.txt", "content");
zip.filter(function (relativePath, file){
  // relativePath == "readme.txt"
  // file = {name:"dir/readme.txt",options:{...},async:function}
  return true/false;
});
```


