freeCodeCamp/curriculum/challenges/portuguese/04-data-visualization/json-apis-and-ajax/get-json-with-the-javascrip...

5.8 KiB
Raw Blame History

id title challengeType videoUrl localeTitle
587d7fae367417b2b2512be3 Get JSON with the JavaScript XMLHttpRequest Method 6 Obtenha o JSON com o método JavaScript XMLHttpRequest

Description

Você também pode solicitar dados de uma fonte externa. É aqui que entram as APIs. Lembre-se de que as APIs - ou Interfaces de Programação de Aplicativos - são ferramentas que os computadores usam para se comunicarem entre si. Você aprenderá a atualizar o HTML com os dados que obtemos das APIs usando uma tecnologia chamada AJAX. A maioria das APIs da web transfere dados em um formato chamado JSON. JSON significa JavaScript Object Notation. A sintaxe JSON é muito semelhante à notação literal do objeto JavaScript. O JSON tem propriedades de objeto e seus valores atuais, entre um { e um } . Essas propriedades e seus valores são geralmente chamados de "pares de valor-chave". No entanto, o JSON transmitido por APIs é enviado como bytes e seu aplicativo o recebe como uma string . Estes podem ser convertidos em objetos JavaScript, mas eles não são objetos JavaScript por padrão. O método JSON.parse analisa a sequência e constrói o objeto JavaScript descrito por ela. Você pode solicitar o JSON da Cat Photo API do freeCodeCamp. Aqui está o código que você pode colocar no seu evento de clique para fazer isso:
req = new XMLHttpRequest ();
req.open ("GET", '/ json / cats.json', true);
req.send ();
req.onload = function () {
json = JSON.parse (req.responseText);
document.getElementsByClassName ('message') [0] .innerHTML = JSON.stringify (json);
};
Aqui está uma revisão do que cada peça está fazendo. O objeto JavaScript XMLHttpRequest possui várias propriedades e métodos usados para transferir dados. Primeiro, uma instância do objeto XMLHttpRequest é criada e salva na variável req . Em seguida, o método open inicializa uma solicitação - este exemplo está solicitando dados de uma API, portanto, é uma solicitação "GET". O segundo argumento para open é o URL da API da qual você está solicitando dados. O terceiro argumento é um valor booleano em que true faz dele uma solicitação assíncrona. O método send envia o pedido. Finalmente, o manipulador de eventos onload analisa os dados retornados e aplica o método JSON.stringify para converter o objeto JavaScript em uma string. Essa sequência é inserida como o texto da mensagem.

Instructions

Atualize o código para criar e enviar uma solicitação "GET" para a FreeCodeCamp Cat Photo API. Em seguida, clique no botão "Obter mensagem". Sua função AJAX substituirá o texto "A mensagem irá para cá" pela saída JSON bruta da API.

Tests

tests:
  - text: Seu código deve criar um novo <code>XMLHttpRequest</code> .
    testString: 'assert(code.match(/new\s+?XMLHttpRequest\(\s*?\)/g), "Your code should create a new <code>XMLHttpRequest</code>.");'
  - text: Seu código deve usar o método <code>open</code> para inicializar uma solicitação &quot;GET&quot; para a FreeCodeCamp Cat Photo API.
    testString: 'assert(code.match(/\.open\(\s*?("|")GET\1\s*?,\s*?("|")\/json\/cats\.json\2\s*?,\s*?true\s*?\)/g), "Your code should use the <code>open</code> method to initialize a "GET" request to the freeCodeCamp Cat Photo API.");'
  - text: Seu código deve usar o <code>send</code> método para enviar o pedido.
    testString: 'assert(code.match(/\.send\(\s*\)/g), "Your code should use the <code>send</code> method to send the request.");'
  - text: Seu código deve ter um manipulador de eventos <code>onload</code> configurado para uma função.
    testString: 'assert(code.match(/\.onload\s*=\s*function\(\s*?\)\s*?{/g), "Your code should have an <code>onload</code> event handler set to a function.");'
  - text: Seu código deve usar o método <code>JSON.parse</code> para analisar o <code>responseText</code> .
    testString: 'assert(code.match(/JSON\.parse\(.*\.responseText\)/g), "Your code should use the <code>JSON.parse</code> method to parse the <code>responseText</code>.");'
  - text: Seu código deve obter o elemento com <code>message</code> classe e alterar seu HTML interno para a string de dados JSON.
    testString: 'assert(code.match(/document\.getElementsByClassName\(\s*?("|")message\1\s*?\)\[0\]\.innerHTML\s*?=\s*?JSON\.stringify\(.+?\)/g), "Your code should get the element with class <code>message</code> and change its inner HTML to the string of JSON data.");'

Challenge Seed

<script>
  document.addEventListener('DOMContentLoaded',function(){
    document.getElementById('getMessage').onclick=function(){
      // Add your code below this line


      // Add your code above this line
    };
  });
</script>
<style>
  body {
    text-align: center;
    font-family: "Helvetica", sans-serif;
  }
  h1 {
    font-size: 2em;
    font-weight: bold;
  }
  .box {
    border-radius: 5px;
    background-color: #eee;
    padding: 20px 5px;
  }
  button {
    color: white;
    background-color: #4791d0;
    border-radius: 5px;
    border: 1px solid #4791d0;
    padding: 5px 10px 8px 10px;
  }
  button:hover {
    background-color: #0F5897;
    border: 1px solid #0F5897;
  }
</style>
<h1>Cat Photo Finder</h1>
<p class="message">
  The message will go here
</p>
<p>
  <button id="getMessage">
    Get Message
  </button>
</p>

Solution

// solution required