Manual:Ajax/pt-br

O MediaWiki oferece uma interface (depreciada) de Ajax para ser usada por extensões. Ajax é um termo usado para quando o JavaScript carrega partes da página sob demanda. O MediaWiki 1.16 implementou o ; consequentemente, o uso do Sajax foi desencorajado.

Portanto, o código JavaScript deve usar como alternativa o (ou o módulo mediawiki.api). Realiza-se uma consulta à API do MediaWiki pelo Ajax (em vez de ).

Solicitações assíncronas
Uma solicitação assíncrona envia alguns dados ao servidor, e continua a execução. Depois de um tempo, o servidor poderá retornar uma resposta (dependendo do tipo da solicitação). Nesse caso, a resposta seria lidada por uma função JavaScript. Outra função pode ser fornecida para lidar com o caso da solicitação falhar por alguma razão. Abaixo está uma chamada de exemplo à API de autenticação usando um nome de usuário e uma senha.

Alternatively, you can use jQuery's functions directly:

The function "mw.util.wikiScript" is available since 1.18 onwards.

Synchronous request
The other kind of request sends some data to the server, and waits for the response. This means that the JavaScript will be blocked until the server returns some data, or the request fails for some reason. The following example retrieves the "What links here" list of a template:

( is a JavaScript standard function that returns an object from its string representation in JSON format.)

Limitations
Due to the same origin policy, it is difficult for a script on an external site to retrieve data from a wiki that is hosted on a different domain &mdash; for example, one cannot directly retrieve data from  to. Newer browsers support an explicit instruction to permit this access via cross-origin resource sharing but this will only work with servers that are configured to issue the appropriate headers, and the user must be using a recent browser that recognises it. Developers with concerns about legacy browsers can't rely on CORS yet.

It is possible to circumvent the Same-Origin policy using JSONP instead of plain JSON which will work in older browsers (including Internet Explorer 6).

Related deprecated functionality
Sajax is an ancient Ajax library that (as of September 2012) is still part of core code and is used by some extensions. Don't use it, use  instead. Some extensions, whether using Sajax or not, make Ajax calls through the obsolete AjaxDispatcher by invoking. They should instead make MediaWiki requests to API modules.