Todos os produtos
Search
Central de documentação

SuperApp:Cross-domain

Última atualização: Jun 29, 2026

O WVCookie fornece JSAPIs de cookies cross-domain para aplicações H5 e mini programs, permitindo ler e gravar cookies em domínios diferentes do domínio da página atual.

Importante

Essas operações de API podem falhar. Trate explicitamente os callbacks success e failure na implementação.

WVCookie.read

Lê todos os cookies de uma URL especificada.

Use JavaScript padrão (document.cookie) para ler cookies do mesmo domínio da página atual. Para ler cookies de um domínio diferente, chame WVCookie.read.

Parâmetros de entrada

  • [string] url: A URL de onde ler os cookies.

Parâmetros de callback

Os parâmetros são passados pelo método de callback. Se a recuperação dos cookies da URL especificada for bem-sucedida, o sistema invocará o callback success; caso contrário, invocará o callback failure.

  • [object] value: Um objeto com todos os cookies da URL especificada como pares chave-valor.

var params = {
        // Replace with the URL whose cookies you want to read.
        url: 'http://xxx.com'
};
window.WindVane.call('WVCookie', 'read', params, function(e) {
        alert('success: ' + JSON.stringify(e));
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});

WVCookie.write

Grava um cookie em um domínio especificado.

Use JavaScript padrão (document.cookie) para gravar um cookie no mesmo domínio da página atual. Para gravar um cookie em um domínio diferente, chame WVCookie.write.

Parâmetros de entrada

  • [string] O nome e o valor do cookie como um par chave-valor. Use qualquer nome de chave desejado. O termo cookieKey no exemplo abaixo é apenas um espaço reservado, não um nome de campo obrigatório.

  • [string] domain: O domínio para o qual o cookie é válido.

  • [string] max-age (opcional): A idade máxima do cookie, em segundos.

  • [string] path (opcional): O caminho para o qual o cookie é válido. O padrão é '/'.

Nota

Inclua outros atributos de cookie, como max-age e path. Defina apenas um cookie por chamada. Para definir vários cookies, chame esta API uma vez para cada cookie.

Parâmetros de callback

O callback não retorna valores. Se a gravação do cookie for bem-sucedida, o sistema invocará o callback success; caso contrário, invocará o callback failure.

// The cookie to write. cookieKey and cookieValue in this example are
// placeholders — replace them with your actual cookie name and value.
var params = {
        cookieKey: 'cookieValue',
        domain: 'h5.m.taobao.com',
};
window.WindVane.call('WVCookie', 'write', params, function(e) {
        alert('success');
}, function(e) {
        alert('failure: ' + JSON.stringify(e));
});