Home » API » session

currentProxyServerIsBad

session.currentProxyServerIsBad() (professional and enterprise editions only)
Description
If screen-scraper is currently using a pool of proxies (either set explicitly or via the automated anonymization feature), calling this method will cause the current proxy server to be removed from the pool. If the automated anonymization feature is being used, this will also cause a new proxy server to be spawned in place of the bad one. This method would be called in situations where a web site starts blocking requests not through some kind of HTTP error (e.g., a status code of 403), but instead by something manifested in the HTML response (e.g., it might contain a message saying, "This IP address has made too many requests."). See the help file on Anonymization for more detail.
Example
// Indicates that the current proxy server is bad.
session.currentProxyServerIsBad();