add filter predicate on session.setCookiesFromResponse

[pocesar]

sometimes you want just one or a couple of cookies from the response. this could be done using an optional filter predicate function or array as a second parameter:

session.setCookiesFromResponse(response, (name, value, allCookiesArray) => {
  // filter function, returns true for including, false otherwise
  return ['PHPSESSID'].includes(name) 
      && allCookiesArray.some((s) => s.name === '_sess');
});
session.setCookiesFromResponse(response, ['PHPSESSID']); // pick cookie name from array

like the Array.filter function, the callback 3rd parameter contains an array of all parsed cookies. this is useful if you want to only include a cookie if another one is present.

at the moment having to resort to:

    if (response.headers['set-cookie'] && response.headers['set-cookie'].length) {
      response.headers['set-cookie'] = response.headers['set-cookie'].filter((s) => {
        return [/* cookie names */].some((key) => {
          return s.startsWith(`${key}=`);
        });
      });
    }

    session.setCookiesFromResponse(response);

session.setPuppeteerCookies accepts a plain { name, value }[], so it's easier to filter before passing to the function