deslizar

Deslize em uma direção específica dentro da viewport ou elemento para Web Desktop/Mobile E Aplicativos Nativos Móveis.

informação

Deslizar para Aplicativos Nativos Móveis é baseado no protocolo de ações W3C, simulando um toque e movimento do dedo. Isso é diferente do mobile: scrollGesture para Android ou mobile: scroll para iOS que são baseados no protocolo do Driver Appium e estão disponíveis apenas para plataformas móveis no contexto NATIVO.

Este comando funciona apenas com os seguintes componentes atualizados:

• Servidor Appium (versão 2.0.0 ou superior)
• appium-uiautomator2-driver (para Android)
• appium-xcuitest-driver (para iOS)

Certifique-se de que seu ambiente Appium local ou baseado em nuvem seja regularmente atualizado para evitar problemas de compatibilidade.

Deslizamento baseado em coordenadas

Evite usar as opções from e to a menos que seja absolutamente necessário. Estas são específicas para dispositivos e podem não funcionar consistentemente em dispositivos diferentes. Use a opção scrollableElement para deslizamentos confiáveis dentro de um elemento.

Parameters

Name	Type	Details
options optional	object, boolean	opções para browser.swipe(). Padrão para desktop/mobile web: { direction: 'up', duration: 1500, percent: 0.95, scrollableElement: WebdriverIO.Element }
options.direction optional	string	Pode ser um de down, up, left ou right, o padrão é up. APENAS-PARA-APLICATIVO-NATIVO-MÓVEL
Para baixo Ponto de início: Você coloca seu dedo próximo à parte superior da tela. Movimento: Você desliza seu dedo para baixo em direção à parte inferior da tela. Ação: Isso também varia conforme o contexto: - Na tela inicial ou em aplicativos, geralmente rola o conteúdo para cima. - A partir da borda superior, frequentemente abre o painel de notificações ou configurações rápidas. - Em navegadores ou aplicativos de leitura, pode ser usado para rolar pelo conteúdo.
Para a esquerda Ponto de início: Você coloca seu dedo no lado direito da tela. Movimento: Você desliza seu dedo horizontalmente para a esquerda.> Ação: A resposta a esse gesto depende do aplicativo: - Pode mover para o próximo item em um carrossel ou conjunto de imagens. - Em um contexto de navegação, pode retornar à página anterior ou fechar a visualização atual. - Na tela inicial, geralmente muda para a próxima área de trabalho virtual ou tela.
Para a direita Ponto de início: Você coloca seu dedo no lado esquerdo da tela. Movimento: Você desliza seu dedo horizontalmente para a direita. Ação: Similar ao deslizamento para a esquerda, mas na direção oposta: -- Muitas vezes move para o item anterior em um carrossel ou galeria. - Pode ser usado para abrir menus laterais ou gavetas de navegação em aplicativos. - Na tela inicial, normalmente muda para a área de trabalho virtual anterior.
Para cima Ponto de início: Você coloca seu dedo próximo à parte inferior da tela. Movimento: Você desliza seu dedo para cima em direção à parte superior da tela.> Ação: Dependendo do contexto, diferentes ações podem ocorrer: - Na tela inicial ou em uma lista, geralmente rola o conteúdo para baixo. - Em um aplicativo de tela cheia, pode abrir opções adicionais ou a gaveta de aplicativos. - Em certas interfaces, pode acionar uma ação de 'atualização' ou abrir uma barra de pesquisa.
options.duration optional	number	A duração em milissegundos para o deslizamento. O padrão é 1500 ms. Quanto menor o valor, mais rápido o deslizamento.
options.scrollableElement optional	Element	Elemento que é usado para deslizar dentro. Se nenhum elemento for fornecido, usará o seguinte seletor para iOS -ios predicate string:type == "XCUIElementTypeApplication" e o seguinte para Android //android.widget.ScrollView'. Se mais elementos corresponderem ao seletor padrão, então por padrão escolherá o primeiro elemento correspondente. APENAS-PARA-APLICATIVO-NATIVO-MÓVEL
options.percent optional	number	A porcentagem do elemento rolável (padrão) para deslizar. Este é um valor entre 0 e 1. O padrão é 0.95. NUNCA deslize a partir do topo|fundo|esquerda|direita exatos da tela, você pode acionar, por exemplo, a barra de notificações ou outros recursos do SO/App, o que pode levar a resultados inesperados. Isso não tem efeito se from e to forem fornecidos.
Os valores abaixo SOMENTE têm efeito se o scrollableElement NÃO for fornecido, caso contrário, eles são ignorados.
options.from optional	object	As coordenadas x e y do início do deslizamento. Se um scrollableElement for fornecido, essas coordenadas não terão efeito.
options.from.x optional	number	A coordenada x do início do deslizamento.
options.from.y optional	number	A coordenada y do início do deslizamento.
options.to optional	object	As coordenadas x e y do fim do deslizamento. Se um scrollableElement for fornecido, essas coordenadas não terão efeito.
options.to.x optional	number	A coordenada x do fim do deslizamento.
options.to.y optional	number	A coordenada y do fim do deslizamento.

Examples

swipe.js

it('should execute a default swipe', async () => {
    // Default will be a swipe from the bottom to the top, meaning it will swipe UP
    await browser.swipe();
});

swipe.with.options.js

it('should execute a swipe with options', async () => {
    await browser.swipe({
        direction: 'left',                  // Swipe from right to left
        duration: 5000,                     // Last for 5 seconds
        percent: 0.5,                       // Swipe 50% of the scrollableElement
        scrollableElement: $('~carousel'),  // The element to swipe within
    })
});