Confirmed users, Bureaucrats and Sysops emeriti
1,680
edits
NPAPI:HTTPRedirectHandling: Difference between revisions
→Specification
| Line 18: | Line 18: | ||
The following function can be implemented by plugins to allow for HTTP redirect handling: | The following function can be implemented by plugins to allow for HTTP redirect handling: | ||
void NPP_URLRedirectNotify(NPP instance, const char* url, | void NPP_URLRedirectNotify(NPP instance, const char* url, | ||
int32 status, void* notifyData | int32 status, void* notifyData); | ||
* instance: The plug-in instance that made the request. | * instance: The plug-in instance that made the request. | ||
| Line 31: | Line 25: | ||
* status: The status code returned from the server (will be 3xx). | * status: The status code returned from the server (will be 3xx). | ||
* notifyData: The data passed into 'NPN_PostURLNotify' or 'NPN_GetURLNotify'. | * notifyData: The data passed into 'NPN_PostURLNotify' or 'NPN_GetURLNotify'. | ||
The browser will look for 'NPP_URLRedirectNotify' only if the plugin function structure's version field is set to the following value or higher: | The browser will look for 'NPP_URLRedirectNotify' only if the plugin function structure's version field is set to the following value or higher: | ||
| Line 39: | Line 32: | ||
The slot for this handler in the plugin function structure can be 'NULL'. If this function is not provided then redirect behavior is up to the browser. The recommended default behavior is to allow all same-origin redirects and disallow all cross-origin redirects. | The slot for this handler in the plugin function structure can be 'NULL'. If this function is not provided then redirect behavior is up to the browser. The recommended default behavior is to allow all same-origin redirects and disallow all cross-origin redirects. | ||
Network requests may time out if a response is not received in a reasonable amount of time. | Plugins respond to HTTP redirect request by calling the following function in the browser's function table: | ||
void NPN_HTTPRedirectResponse(NPP instance, void* notifyData, NPBool allow); | |||
* instance: The plug-in instance that made the request. | |||
* notifyData: The data passed into 'NPN_PostURLNotify' or 'NPN_GetURLNotify'. | |||
* allow: The plugin's response to the last HTTP redirect request. | |||
This function must be available if the browser has called 'NPP_URLRedirectNotify' on the plugin. | |||
Network requests may time out if a response is not received in a reasonable amount of time. 'NPN_HTTPRedirectResponse' can be called during the call to 'NPP_URLRedirectNotify'. | |||
There may be further redirect notifications when a redirect is allowed. When a redirect is disallowed or an asynchronous redirect response is not received within a reasonable amount of time the browser will subsequently issue an 'NPP_URLNotify' call with reason 'NPRES_USER_BREAK' and the last allowed or original url. | There may be further redirect notifications when a redirect is allowed. When a redirect is disallowed or an asynchronous redirect response is not received within a reasonable amount of time the browser will subsequently issue an 'NPP_URLNotify' call with reason 'NPRES_USER_BREAK' and the last allowed or original url. | ||