cuja classe é myforecast-current-lrg. Agora que identificamos o que estávamos procurando, o módulo BeautifulSoup ajudará a encontrar essa informação na string.
Figura 11.5 – Inspecionando o elemento que contém o texto referente à temperatura usando as ferramentas de desenvolvedor.
Fazendo parse de HTML com o módulo BeautifulSoup O Beautiful Soup é um módulo usado para extrair informações de uma página HTML (e é muito melhor para isso do que as expressões regulares). O nome do módulo BeautifulSoup é bs4 (de Beautiful Soup versão 4). Para instalá-lo, será necessário executar pip install beautifulsoup4 na linha de comando. (Dê uma olhada no Apêndice A para obter instruções sobre a instalação de módulos de terceiros.) Embora beautifulsoup4 seja o nome usado na instalação, para importar o Beautiful Soup, execute import bs4. Neste capítulo, os exemplos com Beautiful Soup farão parse (ou seja, analisarão e identificarão partes) de um arquivo HTML no disco rígido. Abra uma nova janela no editor de arquivo do IDLE, digite o programa a seguir e salve-o como example.py. De modo alternativo, você poderá fazer seu
302
download a partir de http://nostarch.com/automatestuff/ .
Download my Python book from my website.
Learn Python the easy way!
By Al Sweigart
. O método select() retornará uma lista de objetos Tag, que é o modo como o Beautiful Soup representa um elemento HTML. A lista conterá um objeto Tag para cada correspondência feita no HTML do objeto BeautifulSoup. Os valores de tag podem ser passados para a função str() para que as tags HTML que representam possam ser mostradas. Os valores de tag também têm um atributo attrs que mostra todos os atributos HTML da tag na forma de um dicionário. Usando o arquivo example.html anterior, digite o seguinte no shell interativo: >>> import bs4 >>> exampleFile = open('example.html') >>> exampleSoup = bs4.BeautifulSoup(exampleFile.read()) >>> elems = exampleSoup.select('#author') do objeto BeautifulSoup. Digite o seguinte no shell interativo: >>> pElems = exampleSoup.select('p') >>> str(pElems[0]) ' Download my Python book from my website. Learn Python the easy way! By Al Sweigart
304
>>> type(elems)
Esse código extrairá o elemento com id="author" de nosso HTML de exemplo. Usamos select('#author') para retornar uma lista contendo todos os elementos com id="author". Armazenamos essa lista de objetos Tag na variável elems e len(elems) nos informa que há um objeto Tag na lista, ou seja, houve uma correspondência. Chamar getText() no elemento fará o texto desse elemento ser retornado, isto é, o HTML interno. O texto de um elemento é o conteúdo entre as tags de abertura e de fechamento: nesse caso, é 'Al Sweigart'. Passar o elemento para str() fará uma string ser retornada com as tags de abertura e de fechamento e o texto do elemento. Por fim, attrs nos fornece um dicionário com o atributo 'id' do elemento e o valor desse atributo, ou seja, 'author'. Podemos também extrair todos os elementos
Desta vez, select() nos forneceu uma lista com três correspondências, que armazenamos em pElems. Usar str() em pElems[0], pElems[1] e pElems[2] mostra cada elemento na forma de uma string, enquanto usar getText() em
305
cada elemento exibe o seu texto.
Obtendo dados dos atributos de um elemento O método get() de objetos Tag facilita acessar valores de atributos de um elemento. O método recebe uma string contendo um nome de atributo e retorna o valor desse atributo. Usando example.html, digite o seguinte no shell interativo: >>> import bs4 >>> soup = bs4.BeautifulSoup(open('example.html')) >>> spanElem = soup.select('span')[0] >>> str(spanElem) 'Al Sweigart' >>> spanElem.get('id') 'author' >>> spanElem.get('some_nonexistent_addr') == None True >>> spanElem.attrs {'id': 'author'}
Nesse caso, usamos select() para encontrar todos os elementos e então armazenamos o primeiro elemento correspondente em spanElem. Passar o nome de atributo 'id' para get() faz o valor do atributo, ou seja, 'author', ser retornado.
Projeto: Pesquisa “Estou com sorte” no Google Sempre que pesquiso um assunto no Google, não olho apenas um resultado da pesquisa de cada vez. Ao clicar em um link de resultado da pesquisa com o botão do meio do mouse (ou clicar enquanto CTRL estiver pressionado), abro os primeiros links em uma porção de novas abas para ler depois. Faço pesquisas no Google com tanta frequência que esse fluxo de trabalho – abrir meu navegador, pesquisar um assunto e clicar em diversos links, um por um, com o botão do meio do mouse – é tedioso. Seria interessante se eu pudesse simplesmente digitar um termo de pesquisa na linha de comando e fazer meu computador abrir automaticamente um navegador com todos os principais resultados da pesquisa em novas abas. Vamos criar um script para fazer isso. Eis o que o seu programa deve fazer: • Obter palavras-chave para pesquisa a partir dos argumentos da linha de comando. • Obter a página com os resultados da pesquisa. • Abrir uma aba do navegador para cada resultado.
306
Isso significa que seu código deverá fazer o seguinte: • Ler os argumentos da linha de comando em sys.argv. • Acessar a página com os resultados da pesquisa usando o módulo requests. • Encontrar os links para cada resultado da pesquisa. • Chamar a função webbrowser.open() para abrir o navegador web. Abra uma nova janela no editor de arquivo e salve esse arquivo como lucky.py.
Passo 1: Obter os argumentos da linha de comando e solicitar a página de pesquisa Antes de codificar algo, inicialmente é preciso conhecer o URL da página com os resultados da pesquisa. Ao observar a barra de endereço do navegador após fazer uma pesquisa no Google, podemos ver que a página de resultados tem um URL semelhante a https://www.google.com/search? q=TERMO_DA_PESQUISA_AQUI . O módulo requests pode fazer download dessa página e, em seguida, o Beautiful Soup poderá ser usado para encontrar os links dos resultados da pesquisa no HTML. Por fim, você usará o módulo webbrowser para abrir esses links nas abas do navegador. Faça o seu código ter o seguinte aspecto: #! python3 # lucky.py – Abre vários resultados de pesquisa no Google. import requests, sys, webbrowser, bs4 print('Googling...') # exibe um texto enquanto faz download da página do Google res = requests.get('http://google.com/search?q=' + ' '.join(sys.argv[1:])) res.raise_for_status() # TODO: Obtém os links dos principais resultados da pesquisa. # TODO: Abre uma aba do navegador para cada resultado.
O usuário especificará os termos da pesquisa usando argumentos da linha de comando quando o programa for iniciado. Esses argumentos serão armazenados como strings em uma lista em sys.argv.
Passo 2: Encontrar todos os resultados Agora você deverá usar o Beautiful Soup para extrair os links dos principais resultados da pesquisa do HTML baixado. Mas como descobrimos qual é o seletor correto para essa tarefa? Por exemplo, não podemos simplesmente
307
procurar todas as tags , pois há muitos links em que não estaremos interessados no HTML. Em vez disso, devemos inspecionar a página com os resultados da pesquisa com as ferramentas de desenvolvedor do navegador e tentar encontrar um seletor que escolha somente os links desejados. Após fazer uma pesquisa no Google em busca de Beautiful Soup, você poderá abrir as ferramentas de desenvolvedor do Google e inspecionar alguns dos elementos que contêm links na página. Eles parecerão extremamente complicados e serão semelhantes a: Beautiful Soup: We called him Tortoise because he taught us.. Não importa se o elemento pareça ser extremamente complicado. Você só precisará encontrar o padrão presente em todos os links do resultado da pesquisa. Porém esse elemento não contém nada que o diferencie facilmente dos elementos que não fazem parte do resultado da pesquisa na página. Faça o seu código ter o seguinte aspecto: #! python3 # lucky.py – Abre vários resultados de pesquisa no Google. import requests, sys, webbrowser, bs4 --trecho removido-# Obtém os links dos principais resultados da pesquisa. soup = bs4.BeautifulSoup(res.text) # Abre uma aba do navegador para cada resultado. linkElems = soup.select('.r a')
Porém, se você observar os dados um pouco antes do elemento , verá que há um elemento como este: . Ao observar o restante do código-fonte HTML, parece que a classe r é usada somente para links contendo resultados da pesquisa. Não é preciso saber o que é a classe CSS r nem o que ela faz. Só iremos usá-la como um marcador para o elemento que estamos procurando. Podemos criar um objeto BeautifulSoup a partir do texto HTML da página baixada e então usar o seletor '.r a' para encontrar todos os elementos que estejam em um elemento que tenha a classe CSS
308
r.
Passo 3: Abrir abas do navegador web para cada resultado Por fim, diremos ao programa para que abra abas no navegador web para os nossos resultados. Acrescente o seguinte no final de seu programa: #! python3 # lucky.py – Abre vários resultados de pesquisa no Google. import requests, sys, webbrowser, bs4 --trecho removido-# Abre uma aba do navegador para cada resultado. linkElems = soup.select('.r a') numOpen = min(5, len(linkElems)) for i in range(numOpen): webbrowser.open('http://google.com' + linkElems[i].get('href'))
Por padrão, abra os cinco primeiros resultados da pesquisa em novas abas usando o módulo webbrowser. Entretanto o usuário poderá ter feito uma pesquisa que obteve menos de cinco resultados. A chamada a soup.select() retorna uma lista de todos os elementos correspondentes ao seu seletor '.r a', portanto o número de abas que você deseja abrir será 5 ou o tamanho dessa lista (o que for menor). A função interna min() do Python retorna o menor argumento inteiro ou de ponto flutuante que receber. (Há também uma função max() interna que retorna o maior argumento recebido.) Podemos usar min() para descobrir se há menos de cinco links na lista e armazenar o número de links a serem abertos em uma variável chamada numOpen. Então um loop for que chame range(numOpen) poderá ser executado. A cada iteração do loop, webbrowser.open() será usado para abrir uma nova aba no navegador web. Observe que o valor do atributo href nos elementos retornados não tem a parte http://google.com inicial, portanto será necessário concatenar esse dado ao valor de string do atributo href. Agora você poderá abrir instantaneamente os cinco primeiros resultados do Google, por exemplo, para Python programming tutorials, ao executar lucky python programming tutorials na linha de comando! (Veja o Apêndice B para saber como executar programas facilmente em seu sistema operacional.)
Ideias para programas semelhantes A vantagem de um navegador com abas está no fato de você poder abrir os
309
links facilmente em novas abas para dar uma olhada posteriormente. Um programa que abra diversos links automaticamente de uma só vez pode ser um bom atalho para fazer o seguinte: • Abrir todas as páginas de produto após pesquisar um site de compras como a Amazon. • Abrir todos os links para avaliações sobre um único produto. • Abrir os links de resultados para fotos após realizar uma pesquisa em um site de fotos como o Flickr ou o Imgur.
Projeto: Downloading de todas as tirinhas XKCD Os blogs e outros sites atualizados regularmente em geral têm uma página inicial com a postagem mais recente, além de um botão Previous (Anterior) na página que conduzirá você à postagem anterior. Então essa postagem também terá um botão Previous e assim sucessivamente, criando um percurso que conduz da página mais recente até a primeira postagem do site. Se quiser uma cópia do conteúdo do site para ler quando não estiver online, você poderá navegar manualmente por todas as páginas e salvar cada uma delas. Contudo esse é um trabalho bem maçante, portanto vamos criar um programa que faça isso. O XKCD é um webcomic popular para geeks com um site que se enquadra nessa estrutura (veja a figura 11.6). A página inicial em http://xkcd.com/ contém um botão Prev (Anterior) que conduz o usuário às tirinhas anteriores. Fazer download de cada tirinha manualmente demoraria muito tempo, porém podemos escrever um script para fazer isso em dois minutos. Eis o que o seu programa deve fazer: • Carregar a página inicial de XKCD. • Salvar a imagem da tirinha que está nessa página. • Seguir o link para Previous Comic (Tirinha anterior). • Repetir até alcançar a primeira tirinha.
310
Figura 11.6 – XKCD, “a webcomic of romance, sarcasm, math, and language” (um webcomic com romance, sarcasmo, matemática e linguagem). Isso significa que seu código deverá fazer o seguinte: • Fazer download de páginas com o módulo requests. • Encontrar o URL da imagem da tirinha em uma página usando o Beautiful Soup. • Fazer download e salvar a imagem da tirinha no disco rígido usando iter_content(). • Encontrar o URL do link Previous Comic (Tirinha anterior) e repetir. Abra uma nova janela no editor de arquivo e salve esse arquivo como downloadXkcd.py.
Passo 1: Design do programa Se você abrir as ferramentas de desenvolvedor do navegador e inspecionar os elementos da página, encontrará o seguinte: • O URL do arquivo de imagem da tirinha é dado pelo atributo href de um elemento . • O elemento
está em um elemento
. • O botão Prev (Anterior) tem um atributo HTML rel cujo valor é prev. • O botão Prev da primeira tirinha está associado ao URL http://xkcd.com/# indicando que não há mais páginas anteriores. Faça o seu código ter o seguinte aspecto: #! python3 # downloadXkcd.py – Faz download de todas as tirinhas de XKCD.
311
import requests, os, bs4 url = 'http://xkcd.com' # url inicial os.makedirs('xkcd', exist_ok=True) # armazena as tirinhas em ./xkcd while not url.endswith('#'): # TODO: Faz download da página. # TODO: Encontra o URL da imagem da tirinha. # TODO: Faz o download da imagem. # TODO: Salva a imagem em ./xkcd. # TODO: Obtém o url do botão Prev. print('Done.')
Você terá uma variável url que começa com o valor 'http://xkcd.com'; ela será repetidamente atualizada (em um loop for) com o URL do link Prev da página atual. A cada passo no loop, a tirinha em url será baixada. Você saberá que o loop deve ser encerrado quando url terminar com '#'. Os arquivos de imagens deverão ser baixados para uma pasta chamada xkcd no diretório de trabalho atual. A chamada a os.makedirs() garante que essa pasta exista, e o argumento nomeado exist_ok=True impede que a função lance uma exceção caso essa pasta já exista. O restante do código contém apenas comentários que descrevem o restante de seu programa.
Passo 2: Download da página web Vamos implementar o código para fazer download da página. Faça o seu código ter o seguinte aspecto: #! python3 # downloadXkcd.py – Faz download de todas as tirinhas de XKCD. import requests, os, bs4 url = 'http://xkcd.com' # url inicial os.makedirs('xkcd', exist_ok=True) # armazena as tirinhas em ./xkcd while not url.endswith('#'): # Faz download da página. print('Downloading page %s...' % url) res = requests.get(url) res.raise_for_status()
soup = bs4.BeautifulSoup(res.text) # TODO: Encontra o URL da imagem da tirinha.
312
# TODO: Faz o download da imagem. # TODO: Salva a imagem em ./xkcd. # TODO: Obtém o url do botão Prev. print('Done.')
Inicialmente, exiba o url para que o usuário saiba qual URL o programa está prestes a baixar; então utilize a função request.get() do módulo requests para fazer o seu download. Como sempre, você chamará o método raise_for_status() do objeto Response imediatamente para lançar uma exceção e encerrar o programa caso um erro tenha ocorrido no download. Do contrário, um objeto BeautifulSoup será criado a partir do texto da página baixada.
Passo 3: Encontrar e fazer download da imagem da tirinha Faça o seu código ter o seguinte aspecto: #! python3 # downloadXkcd.py – Faz download de todas as tirinhas de XKCD. import requests, os, bs4 --trecho removido--
# Encontra o URL da imagem da tirinha. comicElem = soup.select('#comic img') if comicElem == []: print('Could not find comic image.') else: comicUrl = 'http:' + comicElem[0].get('src') # Faz o download da imagem. print('Downloading image %s...' % (comicUrl)) res = requests.get(comicUrl) res.raise_for_status() # TODO: Salva a imagem em ./xkcd. # TODO: Obtém o url do botão Prev. print('Done.')
A partir da inspeção da página inicial de XKCD com suas ferramentas de desenvolvedor, sabemos que o elemento para a imagem da tirinha está em um elemento
com o atributo id definido com comic, portanto o seletor '#comic img' fará você obter o elemento
correto do objeto BeautifulSoup.
313
Algumas páginas do XKCD têm um conteúdo especial que não é simplesmente um arquivo de imagem. Não há problemas nisso; você poderá simplesmente ignorá-las. Se o seu seletor não encontrar nenhum elemento, soup.select('#comic img') retornará uma lista vazia. Quando isso ocorrer, o programa poderá simplesmente exibir uma mensagem de erro e prosseguir sem fazer o download da imagem. Caso contrário, o seletor retornará uma lista contendo um elemento . O atributo src poderá ser obtido desse elemento
e passado para requests.get() para que o download do arquivo com a imagem da tirinha seja feito.
Passo 4: Salvar a imagem e encontrar a tirinha anterior Faça o seu código ter o seguinte aspecto: #! python3 # downloadXkcd.py – Faz download de todas as tirinhas de XKCD. import requests, os, bs4 --trecho removido--
# Salva a imagem em ./xkcd. imageFile = open(os.path.join('xkcd', os.path.basename(comicUrl)), 'wb') for chunk in res.iter_content(100000): imageFile.write(chunk) imageFile.close() # Obtém o url do botão Prev. prevLink = soup.select('a[rel="prev"]')[0] url = 'http://xkcd.com' + prevLink.get('href')
print('Done.')
A essa altura, o arquivo de imagem da tirinha está armazenado na variável res. É preciso gravar os dados dessa imagem em um arquivo no disco rígido. Será necessário ter um nome para o arquivo que conterá a imagem local; esse nome deverá ser passado para open(). comicUrl terá um valor como 'http://imgs.xkcd.com/comics/heartbleed_explanation.png' – que, conforme você deve ter percebido, parece muito com um path de arquivo. Com efeito, podemos chamar os.path.basename() com comicUrl e ele retornará somente a última parte do URL, ou seja, 'heartbleed_explanation.png'. Podemos usar isso como nome do arquivo quando salvarmos a imagem no disco rígido. Junte esse nome ao nome de sua pasta xkcd usando os.path.join() para que seu
314
programa utilize barras invertidas (\) no Windows e barras para frente (/) no OS X e no Linux. Agora que finalmente temos um nome para o arquivo, podemos chamar open() para abrir um novo arquivo em modo 'wb' de “escrita binária”. Lembre-se de que, conforme vimos anteriormente neste capítulo, para salvar arquivos baixados com Requests, devemos percorrer o valor de retorno do método iter_content() com um loop. O código do loop for grava porções de dados da imagem (no máximo 100.000 bytes de cada vez) no arquivo e, em seguida, o arquivo será fechado. A imagem agora está salva em seu disco rígido. Depois disso, o seletor 'a[rel="prev"]' identifica o elemento cujo atributo rel está definido com prev e o atributo href desse elemento poderá ser usado para obter o URL da tirinha anterior, que será armazenado em url. Então o loop while começará todo o processo de download novamente para essa tirinha. A saída desse programa terá a seguinte aparência: Downloading page http://xkcd.com... Downloading image http://imgs.xkcd.com/comics/phone_alarm.png... Downloading page http://xkcd.com/1358/... Downloading image http://imgs.xkcd.com/comics/nro.png... Downloading page http://xkcd.com/1357/... Downloading image http://imgs.xkcd.com/comics/free_speech.png... Downloading page http://xkcd.com/1356/... Downloading image http://imgs.xkcd.com/comics/orbital_mechanics.png... Downloading page http://xkcd.com/1355/... Downloading image http://imgs.xkcd.com/comics/airplane_message.png... Downloading page http://xkcd.com/1354/... Downloading image http://imgs.xkcd.com/comics/heartbleed_explanation.png... --trecho removido--
Esse projeto é um bom exemplo de um programa que pode seguir links automaticamente para extrair grandes quantidades de dados da Web. Você pode conhecer os demais recursos do Beautiful Soup consultando sua documentação em http://www.crummy.com/software/BeautifulSoup/bs4/doc/.
Ideias para programas semelhantes Fazer download de páginas e seguir links formam a base de muitos programas de web crawling. Programas semelhantes também poderão: • Fazer backup de um site completo seguindo todos os seus links. • Copiar todas as mensagens de um fórum web. • Duplicar o catálogo de itens à venda em uma loja online.
315
Os módulos requests e BeautifulSoup são ótimos, desde que você possa determinar o URL que deverá ser passado para requests.get(). Às vezes, porém, não é tão fácil identificá-lo. Pode ser que o site para o qual você quer que seu programa navegue exija um login antes. O módulo selenium proporcionará aos seus programas a capacidade de realizar essas tarefas sofisticadas.
Controlando o navegador com o módulo Selenium O módulo selenium permite que o Python controle diretamente o navegador ao clicar em links e preencher informações de login por meio de programação, quase como se houvesse um ser humano interagindo com a página. O Selenium permite interagir com páginas web de uma maneira muito mais sofisticada que o Requests e o Beautiful Soup; contudo, pelo fato de iniciar um navegador web, ele é um pouco mais lento e difícil de ser executado em background se, por exemplo, for necessário fazer download de apenas alguns arquivos da Web. O Apêndice A contém passos mais detalhados sobre a instalação de módulos de terceiros.
Iniciando um navegador controlado pelo Selenium Para esses exemplos, será necessário ter o navegador web Firefox. Esse será o navegador que você controlará. Se você ainda não tem o Firefox, ele poderá ser baixado gratuitamente a partir de http://getfirefox.com/ . Importar os módulos para o Selenium é um pouco complicado. Em vez de usar import selenium, execute from selenium import webdriver. (O motivo exato pelo qual o módulo selenium está configurado dessa maneira está além do escopo deste livro.) Depois disso, o navegador Firefox poderá ser iniciado com o Selenium. Digite o seguinte no shell interativo: >>> from selenium import webdriver >>> browser = webdriver.Firefox() >>> type(browser)
Você perceberá que, quando webdriver.Firefox() é chamado, o navegador web Firefox é iniciado. Chamar type() com o valor de webdriver.Firefox() mostra que ele é do tipo WebDriver. Além disso, chamar browser.get('http://inventwithpython.com') direciona o navegador para http://inventwithpython.com/ . Seu navegador deverá ter uma aparência
316
semelhante à mostrada na figura 11.7.
Figura 11.7 – Após chamar webdriver.Firefox() e get() no IDLE, o navegador Firefox aparecerá.
Localizando elementos na página Os objetos WebDriver têm alguns métodos para localizar elementos em uma página. Eles são divididos em métodos find_element_* e find_elements_*. Os métodos find_element_* retornam um único objeto WebElement que representa o primeiro elemento da página que corresponda à sua consulta. Os métodos find_elements_* retornam uma lista de objetos WebElement_* contendo todos os elementos correspondentes da página. A tabela 11.3 mostra diversos exemplos de métodos find_element_* e find_elements_* chamados em um objeto WebDriver armazenado na variável browser. Tabela 11.3 – Os métodos de WebDriver do Selenium para encontrar elementos Nome do método
Objeto WebElement/lista retornados
browser.find_element_by_class_name( nome) browser.find_elements_by_class_name( nome)
Elementos que utilizam a classe CSS nome.
browser.find_element_by_css_selector( seletor) browser.find_elements_by_css_selector( seletor)
Elementos que correspondem ao seletor CSS.
browser.find_element_by_id( id) browser.find_elements_by_id( id)
Elementos com um valor de atributo id correspondente.
browser.find_element_by_link_text( texto) browser.find_elements_by_link_text( texto)
Elementos especificado.
que
correspondem
totalmente
ao
texto
browser.find_element_by_partial_link_text( texto) Elementos que contêm o texto especificado. browser.find_elements_by_partial_link_text( texto) browser.find_element_by_name( nome) browser.find_elements_by_name( nome)
Elementos com um valor de atributo nome correspondente.
browser.find_element_by_tag_name( nome)
Elementos com uma tag nome correspondente (sem diferenciar letras maiúsculas de minúsculas; um elemento corresponde a
317
'a' e a 'A').
Exceto pelos métodos *_by_tag_name(), os argumentos para todos os métodos consideram as diferenças entre letras maiúsculas e minúsculas. Se não houver nenhum elemento na página que corresponda ao que o método está procurando, o módulo selenium gerará uma exceção NoSuchElement. Se não quiser que essa exceção provoque uma falha em seu programa, acrescente instruções try e except em seu código. Após ter o objeto WebElement, você poderá descobrir mais sobre ele ao ler os atributos ou chamar os métodos da tabela 11.4. Tabela 11.4 – Atributos e métodos de WebElement Atributo ou método tag_name
Descrição
O nome da tag, por exemplo, 'a' para um elemento .
get_attribute(nome) O valor do atributo nome do elemento. text
O texto do elemento, por exemplo, 'hello' em hello.
clear()
Para campos de texto ou elementos correspondentes à área de texto, limpa o texto digitado.
is_displayed()
Retorna True se o elemento estiver visível; caso contrário, retorna False.
is_enabled()
Para elementos de entrada, retorna True se o elemento estiver habilitado; caso contrário, retorna False.
is_selected()
Para elementos relacionados a caixas de seleção ou botões de rádio, retorna True se o elemento estiver selecionado; caso contrário, retorna False.
location
Um dicionário com chaves 'x' e 'y' para a posição do elemento na página.
Por exemplo, abra uma nova janela no editor de arquivo e digite o código a seguir: from selenium import webdriver browser = webdriver.Firefox() browser.get('http://inventwithpython.com') try: elem = browser.find_element_by_class_name('bookcover') print('Found <%s> element with that class name!' % (elem.tag_name)) except: print('Was not able to find an element with that name.')
Nesse caso, abrimos o Firefox e o direcionamos a um URL. Nessa página, tentamos encontrar elementos com nome de classe igual a 'bookcover' e, caso esse elemento seja encontrado, exibimos seu nome de tag usando o atributo tag_name. Se um elemento desse tipo não for encontrado, exibimos uma mensagem diferente. Esse programa apresentará a saída a seguir: Found element with that class name!
Encontramos um elemento com o nome de classe 'bookcover' e o nome da
318
tag 'img'.
Clicando na página Os objetos WebElement retornados pelos métodos find_element_* e find_elements_* têm um método click() que simula um clique de mouse nesse elemento. Esse método pode ser usado para seguir um link, fazer uma seleção em um botão de rádio, clicar em um botão Submit (Submeter) ou disparar qualquer evento que possa ocorrer quando esse elemento for clicado pelo mouse. Por exemplo, digite o seguinte no shell interativo: >>> from selenium import webdriver >>> browser = webdriver.Firefox() >>> browser.get('http://inventwithpython.com') >>> linkElem = browser.find_element_by_link_text('Read It Online') >>> type(linkElem)
Esses comandos abrem o Firefox em http://inventwithpython.com/ , obtêm o objeto WebElement para o elemento com o texto Read It Online e então simulam um clique nesse elemento . É como se você mesmo tivesse clicado no link; o navegador então seguirá esse link.
Preenchendo e submetendo formulários Enviar teclas aos campos de texto em uma página web é uma questão de encontrar o elemento ou