CINXE.COM
Introdução às Web APIs - Aprendendo desenvolvimento web | MDN
<!doctype html><html lang="en-US" prefix="og: https://ogp.me/ns#"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width,initial-scale=1"/><link rel="icon" href="https://developer.mozilla.org/favicon-48x48.bc390275e955dacb2e65.png"/><link rel="apple-touch-icon" href="https://developer.mozilla.org/apple-touch-icon.528534bba673c38049c2.png"/><meta name="theme-color" content="#ffffff"/><link rel="manifest" href="https://developer.mozilla.org/manifest.f42880861b394dd4dc9b.json"/><link rel="search" type="application/opensearchdescription+xml" href="/opensearch.xml" title="MDN Web Docs"/><title>Introdução às Web APIs - Aprendendo desenvolvimento web | MDN</title><link rel="alternate" title="Einführung in Web-APIs" href="https://developer.mozilla.org/de/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" hrefLang="de"/><link rel="alternate" title="Introduction to web APIs" href="https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" hrefLang="en"/><link rel="alternate" title="Introducción a las APIs web" href="https://developer.mozilla.org/es/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" hrefLang="es"/><link rel="alternate" title="Introduction aux API web" href="https://developer.mozilla.org/fr/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" hrefLang="fr"/><link rel="alternate" title="Web API の紹介" href="https://developer.mozilla.org/ja/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" hrefLang="ja"/><link rel="alternate" title="Введение в web APIs" href="https://developer.mozilla.org/ru/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" hrefLang="ru"/><link rel="alternate" title="Web API 简介" href="https://developer.mozilla.org/zh-CN/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" hrefLang="zh"/><link rel="alternate" title="Introdução às Web APIs" href="https://developer.mozilla.org/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" hrefLang="pt"/><link rel="preload" as="font" type="font/woff2" href="/static/media/Inter.var.c2fe3cb2b7c746f7966a.woff2" crossorigin=""/><link rel="alternate" type="application/rss+xml" title="MDN Blog RSS Feed" href="https://developer.mozilla.org/en-US/blog/rss.xml" hrefLang="en"/><meta name="description" content="Primeiro, vamos ver as APIs a partir de um nível mais alto: o que são, como funcionam, como usá-las em seu código e como são estruturadas? Ainda, vamos entender quais são as principais classes de APIs e quais usos elas possuem."/><meta property="og:url" content="https://developer.mozilla.org/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction"/><meta property="og:title" content="Introdução às Web APIs - Aprendendo desenvolvimento web | MDN"/><meta property="og:type" content="website"/><meta property="og:locale" content="pt_BR"/><meta property="og:description" content="Primeiro, vamos ver as APIs a partir de um nível mais alto: o que são, como funcionam, como usá-las em seu código e como são estruturadas? Ainda, vamos entender quais são as principais classes de APIs e quais usos elas possuem."/><meta property="og:image" content="https://developer.mozilla.org/mdn-social-share.d893525a4fb5fb1f67a2.png"/><meta property="og:image:type" content="image/png"/><meta property="og:image:height" content="1080"/><meta property="og:image:width" content="1920"/><meta property="og:image:alt" content="The MDN Web Docs logo, featuring a blue accent color, displayed on a solid black background."/><meta property="og:site_name" content="MDN Web Docs"/><meta name="twitter:card" content="summary_large_image"/><meta name="twitter:creator" content="MozDevNet"/><link rel="canonical" href="https://developer.mozilla.org/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction"/><style media="print">.article-actions-container,.document-toc-container,.language-menu,.main-menu-toggle,.on-github,.page-footer,.place,.sidebar,.top-banner,.top-navigation-main,ul.prev-next{display:none!important}.main-page-content,.main-page-content pre{padding:2px}.main-page-content pre{border-left-width:2px}</style><script src="/static/js/gtag.js" defer=""></script><script defer="" src="/static/js/main.5e889624.js"></script><link href="/static/css/main.26c64ea7.css" rel="stylesheet"/></head><body><script>if(document.body.addEventListener("load",(t=>{t.target.classList.contains("interactive")&&t.target.setAttribute("data-readystate","complete")}),{capture:!0}),window&&document.documentElement){const t={light:"#ffffff",dark:"#1b1b1b"};try{const e=window.localStorage.getItem("theme");e&&(document.documentElement.className=e,document.documentElement.style.backgroundColor=t[e]);const o=window.localStorage.getItem("nop");o&&(document.documentElement.dataset.nop=o)}catch(t){console.warn("Unable to read theme from localStorage",t)}}</script><div id="root"><ul id="nav-access" class="a11y-nav"><li><a id="skip-main" href="#content">Skip to main content</a></li><li><a id="skip-search" href="#top-nav-search-input">Skip to search</a></li><li><a id="skip-select-language" href="#languages-switcher-button">Skip to select language</a></li></ul><div class="page-wrapper category-javascript document-page"><div class="top-banner loading"><section class="place top container"></section></div><div class="sticky-header-container"><header class="top-navigation "><div class="container "><div class="top-navigation-wrap"><a href="/pt-BR/" class="logo" aria-label="MDN homepage"><svg id="mdn-docs-logo" xmlns="http://www.w3.org/2000/svg" x="0" y="0" viewBox="0 0 694.9 104.4" style="enable-background:new 0 0 694.9 104.4" xml:space="preserve" role="img"><title>MDN Web Docs</title><path d="M40.3 0 11.7 92.1H0L28.5 0h11.8zm10.4 0v92.1H40.3V0h10.4zM91 0 62.5 92.1H50.8L79.3 0H91zm10.4 0v92.1H91V0h10.4z" class="logo-m"></path><path d="M627.9 95.6h67v8.8h-67v-8.8z" class="logo-_"></path><path d="M367 42h-4l-10.7 30.8h-5.5l-10.8-26h-.4l-10.5 26h-5.2L308.7 42h-3.8v-5.6H323V42h-6.5l6.8 20.4h.4l10.3-26h4.7l11.2 26h.5l5.7-20.3h-6.2v-5.6H367V42zm34.9 20c-.4 3.2-2 5.9-4.7 8.2-2.8 2.3-6.5 3.4-11.3 3.4-5.4 0-9.7-1.6-13.1-4.7-3.3-3.2-5-7.7-5-13.7 0-5.7 1.6-10.3 4.7-14s7.4-5.5 12.9-5.5c5.1 0 9.1 1.6 11.9 4.7s4.3 6.9 4.3 11.3c0 1.5-.2 3-.5 4.7h-25.6c.3 7.7 4 11.6 10.9 11.6 2.9 0 5.1-.7 6.5-2 1.5-1.4 2.5-3 3-4.9l6 .9zM394 51.3c.2-2.4-.4-4.7-1.8-6.9s-3.8-3.3-7-3.3c-3.1 0-5.3 1-6.9 3-1.5 2-2.5 4.4-2.8 7.2H394zm51 2.4c0 5-1.3 9.5-4 13.7s-6.9 6.2-12.7 6.2c-6 0-10.3-2.2-12.7-6.7-.1.4-.2 1.4-.4 2.9s-.3 2.5-.4 2.9h-7.3c.3-1.7.6-3.5.8-5.3.3-1.8.4-3.7.4-5.5V22.3h-6v-5.6H416v27c1.1-2.2 2.7-4.1 4.7-5.7 2-1.6 4.8-2.4 8.4-2.4 4.6 0 8.4 1.6 11.4 4.7 3 3.2 4.5 7.6 4.5 13.4zm-7.7.6c0-4.2-1-7.4-3-9.5-2-2.2-4.4-3.3-7.4-3.3-3.4 0-6 1.2-8 3.7-1.9 2.4-2.9 5-3 7.7V57c0 3 1 5.6 3 7.7s4.5 3.1 7.6 3.1c3.6 0 6.3-1.3 8.1-3.9 1.8-2.7 2.7-5.9 2.7-9.6zm69.2 18.5h-13.2v-7.2c-1.2 2.2-2.8 4.1-4.9 5.6-2.1 1.6-4.8 2.4-8.3 2.4-4.8 0-8.7-1.6-11.6-4.9-2.9-3.2-4.3-7.7-4.3-13.3 0-5 1.3-9.6 4-13.7 2.6-4.1 6.9-6.2 12.8-6.2 5.7 0 9.8 2.2 12.3 6.5V22.3h-8.6v-5.6h15.8v50.6h6v5.5zM493.2 56v-4.4c-.1-3-1.2-5.5-3.2-7.3s-4.4-2.8-7.2-2.8c-3.6 0-6.3 1.3-8.2 3.9-1.9 2.6-2.8 5.8-2.8 9.6 0 4.1 1 7.3 3 9.5s4.5 3.3 7.4 3.3c3.2 0 5.8-1.3 7.8-3.8 2.1-2.6 3.1-5.3 3.2-8zm53.1-1.4c0 5.6-1.8 10.2-5.3 13.7s-8.2 5.3-13.9 5.3-10.1-1.7-13.4-5.1c-3.3-3.4-5-7.9-5-13.5 0-5.3 1.6-9.9 4.7-13.7 3.2-3.8 7.9-5.7 14.2-5.7s11 1.9 14.1 5.7c3 3.7 4.6 8.1 4.6 13.3zm-7.7-.2c0-4-1-7.2-3-9.5s-4.8-3.5-8.2-3.5c-3.6 0-6.4 1.2-8.3 3.7s-2.9 5.6-2.9 9.5c0 3.7.9 6.8 2.8 9.4 1.9 2.6 4.6 3.9 8.3 3.9 3.6 0 6.4-1.3 8.4-3.8 1.9-2.6 2.9-5.8 2.9-9.7zm45 5.8c-.4 3.2-1.9 6.3-4.4 9.1-2.5 2.9-6.4 4.3-11.8 4.3-5.2 0-9.4-1.6-12.6-4.8-3.2-3.2-4.8-7.7-4.8-13.7 0-5.5 1.6-10.1 4.7-13.9 3.2-3.8 7.6-5.7 13.2-5.7 2.3 0 4.6.3 6.7.8 2.2.5 4.2 1.5 6.2 2.9l1.5 9.5-5.9.7-1.3-6.1c-2.1-1.2-4.5-1.8-7.2-1.8-3.5 0-6.1 1.2-7.7 3.7-1.7 2.5-2.5 5.7-2.5 9.6 0 4.1.9 7.3 2.7 9.5 1.8 2.3 4.4 3.4 7.8 3.4 5.2 0 8.2-2.9 9.2-8.8l6.2 1.3zm34.7 1.9c0 3.6-1.5 6.5-4.6 8.5s-7 3-11.7 3c-5.7 0-10.6-1.2-14.6-3.6l1.2-8.8 5.7.6-.2 4.7c1.1.5 2.3.9 3.6 1.1s2.6.3 3.9.3c2.4 0 4.5-.4 6.5-1.3 1.9-.9 2.9-2.2 2.9-4.1 0-1.8-.8-3.1-2.3-3.8s-3.5-1.3-5.8-1.7-4.6-.9-6.9-1.4c-2.3-.6-4.2-1.6-5.7-2.9-1.6-1.4-2.3-3.5-2.3-6.3 0-4.1 1.5-6.9 4.6-8.5s6.4-2.4 9.9-2.4c2.6 0 5 .3 7.2.9 2.2.6 4.3 1.4 6.1 2.4l.8 8.8-5.8.7-.8-5.7c-2.3-1-4.7-1.6-7.2-1.6-2.1 0-3.7.4-5.1 1.1-1.3.8-2 2-2 3.8 0 1.7.8 2.9 2.3 3.6 1.5.7 3.4 1.2 5.7 1.6 2.2.4 4.5.8 6.7 1.4 2.2.6 4.1 1.6 5.7 3 1.4 1.6 2.2 3.7 2.2 6.6zM197.6 73.2h-17.1v-5.5h3.8V51.9c0-3.7-.7-6.3-2.1-7.9-1.4-1.6-3.3-2.3-5.7-2.3-3.2 0-5.6 1.1-7.2 3.4s-2.4 4.6-2.5 6.9v15.6h6v5.5h-17.1v-5.5h3.8V51.9c0-3.8-.7-6.4-2.1-7.9-1.4-1.5-3.3-2.3-5.6-2.3-3.2 0-5.5 1.1-7.2 3.3-1.6 2.2-2.4 4.5-2.5 6.9v15.8h6.9v5.5h-20.2v-5.5h6V42.4h-6.1v-5.6h13.4v6.4c1.2-2.1 2.7-3.8 4.7-5.2 2-1.3 4.4-2 7.3-2s5.3.7 7.5 2.1c2.2 1.4 3.7 3.5 4.5 6.4 1.1-2.5 2.7-4.5 4.9-6.1s4.8-2.4 7.9-2.4c3.5 0 6.5 1.1 8.9 3.3s3.7 5.6 3.7 10.2v18.2h6.1v5.5zm42.5 0h-13.2V66c-1.2 2.2-2.8 4.1-4.9 5.6-2.1 1.6-4.8 2.4-8.3 2.4-4.8 0-8.7-1.6-11.6-4.9-2.9-3.2-4.3-7.7-4.3-13.3 0-5 1.3-9.6 4-13.7 2.6-4.1 6.9-6.2 12.8-6.2s9.8 2.2 12.3 6.5V22.7h-8.6v-5.6h15.8v50.6h6v5.5zm-13.3-16.8V52c-.1-3-1.2-5.5-3.2-7.3s-4.4-2.8-7.2-2.8c-3.6 0-6.3 1.3-8.2 3.9-1.9 2.6-2.8 5.8-2.8 9.6 0 4.1 1 7.3 3 9.5s4.5 3.3 7.4 3.3c3.2 0 5.8-1.3 7.8-3.8 2.1-2.6 3.1-5.3 3.2-8zm61.5 16.8H269v-5.5h6V51.9c0-3.7-.7-6.3-2.2-7.9-1.4-1.6-3.4-2.3-5.7-2.3-3.1 0-5.6 1-7.4 3s-2.8 4.4-2.9 7v15.9h6v5.5h-19.3v-5.5h6V42.4h-6.2v-5.6h13.6V43c2.6-4.6 6.8-6.9 12.7-6.9 3.6 0 6.7 1.1 9.2 3.3s3.7 5.6 3.7 10.2v18.2h6v5.4h-.2z" class="logo-text"></path></svg></a><button title="Open main menu" type="button" class="button action has-icon main-menu-toggle" aria-haspopup="menu" aria-label="Open main menu" aria-expanded="false"><span class="button-wrap"><span class="icon icon-menu "></span><span class="visually-hidden">Open main menu</span></span></button></div><div class="top-navigation-main"><nav class="main-nav" aria-label="Main menu"><ul class="main-menu nojs"><li class="top-level-entry-container "><button type="button" id="references-button" class="top-level-entry menu-toggle" aria-controls="references-menu" aria-expanded="false">References</button><a href="/pt-BR/docs/Web" class="top-level-entry">References</a><ul id="references-menu" class="submenu references hidden inline-submenu-lg" aria-labelledby="references-button"><li class="apis-link-container mobile-only "><a href="/pt-BR/docs/Web" class="submenu-item "><div class="submenu-icon"></div><div class="submenu-content-container"><div class="submenu-item-heading">Overview / Web Technology</div><p class="submenu-item-description">Web technology reference for developers</p></div></a></li><li class="html-link-container "><a href="/pt-BR/docs/Web/HTML" class="submenu-item "><div class="submenu-icon html"></div><div class="submenu-content-container"><div class="submenu-item-heading">HTML</div><p class="submenu-item-description">Structure of content on the web</p></div></a></li><li class="css-link-container "><a href="/pt-BR/docs/Web/CSS" class="submenu-item "><div class="submenu-icon css"></div><div class="submenu-content-container"><div class="submenu-item-heading">CSS</div><p class="submenu-item-description">Code used to describe document style</p></div></a></li><li class="javascript-link-container "><a href="/pt-BR/docs/Web/JavaScript" class="submenu-item "><div class="submenu-icon javascript"></div><div class="submenu-content-container"><div class="submenu-item-heading">JavaScript</div><p class="submenu-item-description">General-purpose scripting language</p></div></a></li><li class="http-link-container "><a href="/pt-BR/docs/Web/HTTP" class="submenu-item "><div class="submenu-icon http"></div><div class="submenu-content-container"><div class="submenu-item-heading">HTTP</div><p class="submenu-item-description">Protocol for transmitting web resources</p></div></a></li><li class="apis-link-container "><a href="/pt-BR/docs/Web/API" class="submenu-item "><div class="submenu-icon apis"></div><div class="submenu-content-container"><div class="submenu-item-heading">Web APIs</div><p class="submenu-item-description">Interfaces for building web applications</p></div></a></li><li class="apis-link-container "><a href="/pt-BR/docs/Mozilla/Add-ons/WebExtensions" class="submenu-item "><div class="submenu-icon"></div><div class="submenu-content-container"><div class="submenu-item-heading">Web Extensions</div><p class="submenu-item-description">Developing extensions for web browsers</p></div></a></li><li class="apis-link-container desktop-only "><a href="/pt-BR/docs/Web" class="submenu-item "><div class="submenu-icon"></div><div class="submenu-content-container"><div class="submenu-item-heading">Web Technology</div><p class="submenu-item-description">Web technology reference for developers</p></div></a></li></ul></li><li class="top-level-entry-container active"><button type="button" id="guides-button" class="top-level-entry menu-toggle" aria-controls="guides-menu" aria-expanded="false">Guides</button><a href="/pt-BR/docs/Learn" class="top-level-entry">Guides</a><ul id="guides-menu" class="submenu guides hidden inline-submenu-lg" aria-labelledby="guides-button"><li class="apis-link-container mobile-only "><a href="/pt-BR/docs/Learn" class="submenu-item "><div class="submenu-icon learn"></div><div class="submenu-content-container"><div class="submenu-item-heading">Overview / MDN Learning Area</div><p class="submenu-item-description">Learn web development</p></div></a></li><li class="apis-link-container desktop-only "><a href="/pt-BR/docs/Learn" class="submenu-item "><div class="submenu-icon learn"></div><div class="submenu-content-container"><div class="submenu-item-heading">MDN Learning Area</div><p class="submenu-item-description">Learn web development</p></div></a></li><li class="html-link-container "><a href="/pt-BR/docs/Learn/HTML" class="submenu-item "><div class="submenu-icon html"></div><div class="submenu-content-container"><div class="submenu-item-heading">HTML</div><p class="submenu-item-description">Learn to structure web content with HTML</p></div></a></li><li class="css-link-container "><a href="/pt-BR/docs/Learn/CSS" class="submenu-item "><div class="submenu-icon css"></div><div class="submenu-content-container"><div class="submenu-item-heading">CSS</div><p class="submenu-item-description">Learn to style content using CSS</p></div></a></li><li class="javascript-link-container "><a href="/pt-BR/docs/Learn/JavaScript" class="submenu-item "><div class="submenu-icon javascript"></div><div class="submenu-content-container"><div class="submenu-item-heading">JavaScript</div><p class="submenu-item-description">Learn to run scripts in the browser</p></div></a></li><li class=" "><a href="/pt-BR/docs/Web/Accessibility" class="submenu-item "><div class="submenu-icon"></div><div class="submenu-content-container"><div class="submenu-item-heading">Accessibility</div><p class="submenu-item-description">Learn to make the web accessible to all</p></div></a></li></ul></li><li class="top-level-entry-container "><button type="button" id="mdn-plus-button" class="top-level-entry menu-toggle" aria-controls="mdn-plus-menu" aria-expanded="false">Plus</button><a href="/pt-BR/plus" class="top-level-entry">Plus</a><ul id="mdn-plus-menu" class="submenu mdn-plus hidden inline-submenu-lg" aria-labelledby="mdn-plus-button"><li class=" "><a href="/pt-BR/plus" class="submenu-item "><div class="submenu-icon"></div><div class="submenu-content-container"><div class="submenu-item-heading">Overview</div><p class="submenu-item-description">A customized MDN experience</p></div></a></li><li class=" "><a href="/pt-BR/plus/ai-help" class="submenu-item "><div class="submenu-icon"></div><div class="submenu-content-container"><div class="submenu-item-heading">AI Help</div><p class="submenu-item-description">Get real-time assistance and support</p></div></a></li><li class=" "><a href="/pt-BR/plus/updates" class="submenu-item "><div class="submenu-icon"></div><div class="submenu-content-container"><div class="submenu-item-heading">Updates</div><p class="submenu-item-description">All browser compatibility updates at a glance</p></div></a></li><li class=" "><a href="/en-US/plus/docs/features/overview" class="submenu-item "><div class="submenu-icon"></div><div class="submenu-content-container"><div class="submenu-item-heading">Documentation</div><p class="submenu-item-description">Learn how to use MDN Plus</p></div></a></li><li class=" "><a href="/en-US/plus/docs/faq" class="submenu-item "><div class="submenu-icon"></div><div class="submenu-content-container"><div class="submenu-item-heading">FAQ</div><p class="submenu-item-description">Frequently asked questions about MDN Plus</p></div></a></li></ul></li><li class="top-level-entry-container "><a class="top-level-entry menu-link" href="/en-US/curriculum/">Curriculum <sup class="new">New</sup></a></li><li class="top-level-entry-container "><a class="top-level-entry menu-link" href="/en-US/blog/">Blog</a></li><li class="top-level-entry-container "><button type="button" id="tools-button" class="top-level-entry menu-toggle" aria-controls="tools-menu" aria-expanded="false">Tools</button><ul id="tools-menu" class="submenu tools hidden inline-submenu-lg" aria-labelledby="tools-button"><li class=" "><a href="/pt-BR/play" class="submenu-item "><div class="submenu-icon"></div><div class="submenu-content-container"><div class="submenu-item-heading">Playground</div><p class="submenu-item-description">Write, test and share your code</p></div></a></li><li class=" "><a href="/en-US/observatory" class="submenu-item "><div class="submenu-icon"></div><div class="submenu-content-container"><div class="submenu-item-heading">HTTP Observatory</div><p class="submenu-item-description">Scan a website for free</p></div></a></li><li class=" "><a href="/en-US/plus/ai-help" class="submenu-item "><div class="submenu-icon"></div><div class="submenu-content-container"><div class="submenu-item-heading">AI Help</div><p class="submenu-item-description">Get real-time assistance and support</p></div></a></li></ul></li></ul></nav><div class="header-search"><form action="/pt-BR/search" class="search-form search-widget" id="top-nav-search-form" role="search"><label id="top-nav-search-label" for="top-nav-search-input" class="visually-hidden">Search MDN</label><input aria-activedescendant="" aria-autocomplete="list" aria-controls="top-nav-search-menu" aria-expanded="false" aria-labelledby="top-nav-search-label" autoComplete="off" id="top-nav-search-input" role="combobox" type="search" class="search-input-field" name="q" placeholder=" " required="" value=""/><button type="button" class="button action has-icon clear-search-button"><span class="button-wrap"><span class="icon icon-cancel "></span><span class="visually-hidden">Clear search input</span></span></button><button type="submit" class="button action has-icon search-button"><span class="button-wrap"><span class="icon icon-search "></span><span class="visually-hidden">Search</span></span></button><div id="top-nav-search-menu" role="listbox" aria-labelledby="top-nav-search-label"></div></form></div><div class="theme-switcher-menu"><button type="button" class="button action has-icon theme-switcher-menu small" aria-haspopup="menu"><span class="button-wrap"><span class="icon icon-theme-os-default "></span>Theme</span></button></div><ul class="auth-container"><li><a href="/users/fxa/login/authenticate/?next=%2Fpt-BR%2Fdocs%2FLearn%2FJavaScript%2FClient-side_web_APIs%2FIntroduction" class="login-link" rel="nofollow">Log in</a></li><li><a href="/users/fxa/login/authenticate/?next=%2Fpt-BR%2Fdocs%2FLearn%2FJavaScript%2FClient-side_web_APIs%2FIntroduction" target="_self" rel="nofollow" class="button primary mdn-plus-subscribe-link"><span class="button-wrap">Sign up for free</span></a></li></ul></div></div></header><div class="article-actions-container"><div class="container"><button type="button" class="button action has-icon sidebar-button" aria-label="Expand sidebar" aria-expanded="false" aria-controls="sidebar-quicklinks"><span class="button-wrap"><span class="icon icon-sidebar "></span></span></button><nav class="breadcrumbs-container" aria-label="Breadcrumb"><ol typeof="BreadcrumbList" vocab="https://schema.org/" aria-label="breadcrumbs"><li property="itemListElement" typeof="ListItem"><a href="/pt-BR/docs/Learn" class="breadcrumb" property="item" typeof="WebPage"><span property="name">Aprendendo desenvolvimento web</span></a><meta property="position" content="1"/></li><li property="itemListElement" typeof="ListItem"><a href="/pt-BR/docs/Learn/JavaScript" class="breadcrumb" property="item" typeof="WebPage"><span property="name">JavaScript</span></a><meta property="position" content="2"/></li><li property="itemListElement" typeof="ListItem"><a href="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs" class="breadcrumb" property="item" typeof="WebPage"><span property="name">APIs web do lado cliente</span></a><meta property="position" content="3"/></li><li property="itemListElement" typeof="ListItem"><a href="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" class="breadcrumb-current-page" property="item" typeof="WebPage"><span property="name">Introdução às Web APIs</span></a><meta property="position" content="4"/></li></ol></nav><div class="article-actions"><button type="button" class="button action has-icon article-actions-toggle" aria-label="Article actions"><span class="button-wrap"><span class="icon icon-ellipses "></span><span class="article-actions-dialog-heading">Article Actions</span></span></button><ul class="article-actions-entries"><li class="article-actions-entry"><div class="languages-switcher-menu open-on-focus-within"><button id="languages-switcher-button" type="button" class="button action small has-icon languages-switcher-menu" aria-haspopup="menu"><span class="button-wrap"><span class="icon icon-language "></span>Português (do Brasil)</span></button><div class="hidden"><ul class="submenu language-menu " aria-labelledby="language-menu-button"><li class=" "><form class="submenu-item locale-redirect-setting"><div class="group"><label class="switch"><input type="checkbox" name="locale-redirect"/><span class="slider"></span><span class="label">Remember language</span></label><a href="https://github.com/orgs/mdn/discussions/739" rel="external noopener noreferrer" target="_blank" title="Enable this setting to automatically switch to this language when it's available. (Click to learn more.)"><span class="icon icon-question-mark "></span></a></div></form></li><li class=" "><a data-locale="de" href="/de/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" class="button submenu-item"><span>Deutsch</span><span title="Diese Übersetzung ist Teil eines Experiments."><span class="icon icon-experimental "></span></span></a></li><li class=" "><a data-locale="en-US" href="/en-US/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" class="button submenu-item"><span>English (US)</span></a></li><li class=" "><a data-locale="es" href="/es/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" class="button submenu-item"><span>Español</span></a></li><li class=" "><a data-locale="fr" href="/fr/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" class="button submenu-item"><span>Français</span></a></li><li class=" "><a data-locale="ja" href="/ja/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" class="button submenu-item"><span>日本語</span></a></li><li class=" "><a data-locale="ru" href="/ru/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" class="button submenu-item"><span>Русский</span></a></li><li class=" "><a data-locale="zh-CN" href="/zh-CN/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" class="button submenu-item"><span>中文 (简体)</span></a></li></ul></div></div></li></ul></div></div></div></div><div class="container"><div class="notecard localized-content-note"><p><a href="/pt-BR/docs/MDN/Community/Contributing/Translated_content#locais_ativos">Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.</a></p></div></div><div class="main-wrapper"><div class="sidebar-container"><aside id="sidebar-quicklinks" class="sidebar" data-macro="LearnSidebar"><button type="button" class="button action backdrop" aria-label="Collapse sidebar"><span class="button-wrap"></span></button><nav aria-label="Related Topics" class="sidebar-inner"><header class="sidebar-actions"><section class="sidebar-filter-container"><div class="sidebar-filter "><label id="sidebar-filter-label" class="sidebar-filter-label" for="sidebar-filter-input"><span class="icon icon-filter"></span><span class="visually-hidden">Filter sidebar</span></label><input id="sidebar-filter-input" autoComplete="off" class="sidebar-filter-input-field false" type="text" placeholder="Filter" value=""/><button type="button" class="button action has-icon clear-sidebar-filter-button"><span class="button-wrap"><span class="icon icon-cancel "></span><span class="visually-hidden">Clear filter input</span></span></button></div></section></header><div class="sidebar-inner-nav"><div class="in-nav-toc"><div class="document-toc-container"><section class="document-toc"><header><h2 class="document-toc-heading">Neste artigo</h2></header><ul class="document-toc-list"><li class="document-toc-item "><a class="document-toc-link" href="#o_que_são_apis">O que são APIs?</a></li><li class="document-toc-item "><a class="document-toc-link" href="#o_que_as_apis_podem_fazer">O que as APIs podem fazer?</a></li><li class="document-toc-item "><a class="document-toc-link" href="#como_as_apis_funcionam">Como as APIs funcionam?</a></li><li class="document-toc-item "><a class="document-toc-link" href="#resumo">Resumo</a></li></ul></section></div></div><div class="sidebar-body"><ol><li class="section"><a href="/pt-BR/docs/Learn/Getting_started_with_the_web">Completos iniciantes, comecem por aqui!</a></li><li><details><summary>Iniciando na Internet</summary><ol><li><a href="/pt-BR/docs/Learn/Getting_started_with_the_web">Introdução à Web</a></li><li><a href="/pt-BR/docs/Learn/Getting_started_with_the_web/Installing_basic_software">Instalando os programas básicos</a></li><li><a href="/pt-BR/docs/Learn/Getting_started_with_the_web/What_will_your_website_look_like">Como será o seu site?</a></li><li><a href="/pt-BR/docs/Learn/Getting_started_with_the_web/Dealing_with_files">Lidando com arquivos</a></li><li><a href="/pt-BR/docs/Learn/Getting_started_with_the_web/HTML_basics">HTML básico</a></li><li><a href="/pt-BR/docs/Learn/Getting_started_with_the_web/CSS_basics">CSS básico</a></li><li><a href="/pt-BR/docs/Learn/Getting_started_with_the_web/JavaScript_basics">Noções básicas de JavaScript</a></li><li><a href="/pt-BR/docs/Learn/Getting_started_with_the_web/Publishing_your_website">Publicando seu site</a></li><li><a href="/pt-BR/docs/Learn/Getting_started_with_the_web/How_the_Web_works">Como a Web funciona</a></li></ol></details></li><li class="section"><a href="/pt-BR/docs/Learn/HTML">HTML — Estruturando a Web</a></li><li><details><summary>Introdução ao HTML</summary><ol><li><a href="/pt-BR/docs/Learn/HTML/Introduction_to_HTML">Introdução ao HTML</a></li><li><a href="/pt-BR/docs/Learn/HTML/Introduction_to_HTML/Getting_started">Iniciando com HTML</a></li><li><a href="/pt-BR/docs/Learn/HTML/Introduction_to_HTML/The_head_metadata_in_HTML">O que está no cabeçalho? Metadados em HTML</a></li><li><a href="/pt-BR/docs/Learn/HTML/Introduction_to_HTML/HTML_text_fundamentals">Fundamentos do texto em HTML</a></li><li><a href="/pt-BR/docs/Learn/HTML/Introduction_to_HTML/Creating_hyperlinks">Criando hyperlinks</a></li><li><a href="/pt-BR/docs/Learn/HTML/Introduction_to_HTML/Advanced_text_formatting">Formatação avançada de texto</a></li><li><a href="/pt-BR/docs/Learn/HTML/Introduction_to_HTML/Document_and_website_structure">Estrutura de documento e sites</a></li><li><a href="/pt-BR/docs/Learn/HTML/Introduction_to_HTML/Debugging_HTML">Debugging HTML</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/HTML/Introduction_to_HTML/Marking_up_a_letter">Marking up a letter</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/HTML/Introduction_to_HTML/Structuring_a_page_of_content">Structuring a page of content</a></li></ol></details></li><li><details><summary>Multimídia e incorporação</summary><ol><li><a href="/pt-BR/docs/Learn/HTML/Multimedia_and_embedding">Multimídia e Incorporação</a></li><li><a href="/pt-BR/docs/Learn/HTML/Multimedia_and_embedding/Images_in_HTML">Imagens no HTML</a></li><li><a href="/pt-BR/docs/Learn/HTML/Multimedia_and_embedding/Video_and_audio_content">Conteúdo de vídeo e áudio</a></li><li><a href="/pt-BR/docs/Learn/HTML/Multimedia_and_embedding/Other_embedding_technologies">Do objeto ao iframe - outras tecnologias de incorporação</a></li><li><a href="/pt-BR/docs/Learn/HTML/Multimedia_and_embedding/Adding_vector_graphics_to_the_Web">Adicionando vetor gráfico na web</a></li><li><a href="/pt-BR/docs/Learn/HTML/Multimedia_and_embedding/Responsive_images">Imagens responsivas</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/HTML/Multimedia_and_embedding/Mozilla_splash_page">Mozilla splash page</a></li></ol></details></li><li><details><summary>Tabelas HTML</summary><ol><li><a href="/pt-BR/docs/Learn/HTML/Tables">Tabelas em HTML</a></li><li><a href="/pt-BR/docs/Learn/HTML/Tables/Basics">HTML table basics</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/HTML/Tables/Advanced">HTML table advanced features and accessibility</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/HTML/Tables/Structuring_planet_data">Structuring planet data</a></li></ol></details></li><li class="section"><a href="/pt-BR/docs/Learn/CSS">CSS — Estilizando a Web</a></li><li><details><summary>CSS - primeiros passos</summary><ol><li><a href="/pt-BR/docs/Learn/CSS/First_steps">Primeiros passos com CSS</a></li><li><a href="/pt-BR/docs/Learn/CSS/First_steps/What_is_CSS">O que é CSS?</a></li><li><a href="/pt-BR/docs/Learn/CSS/First_steps/Getting_started">Iniciando com CSS</a></li><li><a href="/pt-BR/docs/Learn/CSS/First_steps/How_CSS_is_structured">Como CSS é estruturado</a></li><li><a href="/pt-BR/docs/Learn/CSS/First_steps/How_CSS_works">Como funciona o CSS</a></li><li><a href="/pt-BR/docs/Learn/CSS/First_steps/Styling_a_biography_page">Usando seu novo conhecimento</a></li></ol></details></li><li><details><summary>CSS building blocks</summary><ol><li><a href="/pt-BR/docs/Learn/CSS/Building_blocks">Construindo blocos CSS</a></li><li><a href="/pt-BR/docs/Learn/CSS/Building_blocks/Selectors">CSS selectors</a></li><li><a href="/pt-BR/docs/Learn/CSS/Building_blocks/Selectors/Type_Class_and_ID_Selectors">Seletores de tipo, classe e ID</a></li><li><a href="/pt-BR/docs/Learn/CSS/Building_blocks/Selectors/Attribute_selectors">Seletores de atributo</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Selectors/Pseudo-classes_and_pseudo-elements">Pseudo-classes and pseudo-elements</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Selectors/Combinators">Combinators</a></li><li><a href="/pt-BR/docs/Learn/CSS/Building_blocks/Cascade_and_inheritance">Cascata, especificidade e herança</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Cascade_layers">Cascade layers</a></li><li><a href="/pt-BR/docs/Learn/CSS/Building_blocks/The_box_model">The box model</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Backgrounds_and_borders">Backgrounds and borders</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Handling_different_text_directions">Handling different text directions</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Overflowing_content">Overflowing content</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Values_and_units">CSS values and units</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Sizing_items_in_CSS">Sizing items in CSS</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Images_media_form_elements">Images, media, and form elements</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Styling_tables">Styling tables</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Advanced_styling_effects">Advanced styling effects</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Debugging_CSS">Debugging CSS</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Organizing">Organizing your CSS</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Fundamental_CSS_comprehension">Fundamental CSS comprehension</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/Creating_fancy_letterheaded_paper">Creating fancy letterheaded paper</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Building_blocks/A_cool_looking_box">A cool-looking box</a></li></ol></details></li><li><details><summary>Estilização de textos</summary><ol><li><a href="/pt-BR/docs/Learn/CSS/Styling_text">Estilizando texto</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Styling_text/Fundamentals">Fundamental text and font styling</a></li><li><a href="/pt-BR/docs/Learn/CSS/Styling_text/Styling_lists">Manipulando Listas</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Styling_text/Styling_links">Styling links</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Styling_text/Web_fonts">Web fonts</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Styling_text/Typesetting_a_homepage">Typesetting a community school homepage</a></li></ol></details></li><li><details><summary>Esquemas CSS</summary><ol><li><a href="/pt-BR/docs/Learn/CSS/CSS_layout">CSS layout</a></li><li><a href="/pt-BR/docs/Learn/CSS/CSS_layout/Introduction">Introdução ao leiaute com CSS</a></li><li><a href="/pt-BR/docs/Learn/CSS/CSS_layout/Normal_Flow">Fluxo Normal</a></li><li><a href="/pt-BR/docs/Learn/CSS/CSS_layout/Flexbox">Flexbox</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/CSS_layout/Grids">Grids</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/CSS_layout/Floats">Floats</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/CSS_layout/Positioning">Positioning</a></li><li><a href="/pt-BR/docs/Learn/CSS/CSS_layout/Multiple-column_Layout">Layout de varias colunas</a></li><li><a href="/pt-BR/docs/Learn/CSS/CSS_layout/Responsive_Design">Design Responsivo</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/CSS_layout/Media_queries">Beginner's guide to media queries</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/CSS_layout/Legacy_Layout_Methods">Legacy layout methods</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/CSS_layout/Supporting_Older_Browsers">Supporting older browsers</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/CSS_layout/Fundamental_Layout_Comprehension">Fundamental layout comprehension</a></li></ol></details></li><li class="section"><a href="/pt-BR/docs/Learn/JavaScript">JavaScript — Uma linguagem de script dinâmica para aplicações cliente</a></li><li><details><summary>Primeiros passos com JavaScript</summary><ol><li><a href="/pt-BR/docs/Learn/JavaScript/First_steps">Primeiros passos com JavaScript</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/First_steps/What_is_JavaScript">O que é JavaScript?</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/First_steps/A_first_splash">Um primeiro mergulho no JavaScript</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/First_steps/What_went_wrong">O que deu errado? Resolvendo problemas no JavaScript</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/First_steps/Variables">Armazenando as informações que você precisa — Variáveis</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/First_steps/Math">Matemática básica no JavaScript — números e operadores</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/First_steps/Strings">Trabalhando com texto — strings em JavaScript</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/First_steps/Useful_string_methods">Métodos úteis de string</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/First_steps/Arrays">Arrays</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/First_steps/Silly_story_generator">Gerador de histórias bobas</a></li></ol></details></li><li><details><summary>Programando em JavaScript</summary><ol><li><a href="/pt-BR/docs/Learn/JavaScript/Building_blocks">Elementos construtivos do Javascript</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Building_blocks/conditionals">Tomando decisões no seu código — condicionais</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Building_blocks/Looping_code">Código em loop</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Building_blocks/Functions">Funções — blocos reutilizáveis de código</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Building_blocks/Build_your_own_function">Construa sua própria função</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Building_blocks/Return_values">Valores de retorno de função</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Building_blocks/Events">Introdução a eventos</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Building_blocks/Event_bubbling">Comparativo entre Event Targets</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Building_blocks/Image_gallery">Galeria de Imagens</a></li></ol></details></li><li><details><summary>Introdução Objetos em JavaScript</summary><ol><li><a href="/pt-BR/docs/Learn/JavaScript/Objects">Introdução a objetos em Javascript</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Objects/Basics">O básico sobre objetos JavaScript</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Objects/Object_prototypes">Protótipos de objetos</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/JavaScript/Objects/Object-oriented_programming">Object-oriented programming</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Objects/Classes_in_JavaScript">Herança em JavaScript</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Objects/JSON">Trabalhando com JSON</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Objects/Object_building_practice">Prática de construção de objetos</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Objects/Adding_bouncing_balls_features">Adicionando recursos à nossa demonstração de bolas pulantes</a></li></ol></details></li><li><details><summary>Asynchronous JavaScript</summary><ol><li><a href="/pt-BR/docs/Learn/JavaScript/Asynchronous">JavaScript Assíncrono</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Asynchronous/Introducing">Introdução ao JavaScript Async</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Asynchronous/Promises">Como usar Promises</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/JavaScript/Asynchronous/Implementing_a_promise-based_API">How to implement a promise-based API</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/JavaScript/Asynchronous/Introducing_workers">Introducing workers</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/JavaScript/Asynchronous/Sequencing_animations">Sequencing animations</a></li></ol></details></li><li><details open=""><summary>APIs Web na aplicação Cliente</summary><ol><li><a href="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs">APIs web do lado cliente</a></li><li><em><a href="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction" aria-current="page">Introdução às Web APIs</a></em></li><li><a href="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Manipulating_documents">JavaScript e CSS</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Fetching_data">AJAX</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/JavaScript/Client-side_web_APIs/Third_party_APIs">Third-party APIs</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/JavaScript/Client-side_web_APIs/Drawing_graphics">Drawing graphics</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/JavaScript/Client-side_web_APIs/Video_and_audio_APIs">Video and Audio APIs</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Client-side_storage">Client-side storage</a></li></ol></details></li><li class="section"><a href="/pt-BR/docs/Learn/Forms">Web forms — Working with user data</a></li><li><details><summary>Web form building blocks</summary><ol><li><a href="/pt-BR/docs/Learn/Forms">Formulários da Web - Trabalhando com dados do usuário</a></li><li><a href="/pt-BR/docs/Learn/Forms/Your_first_form">Meu primeiro formulário HTML</a></li><li><a href="/pt-BR/docs/Learn/Forms/How_to_structure_a_web_form">Como estruturar um formulário HTML</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Forms/Basic_native_form_controls">Basic native form controls</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Forms/HTML5_input_types">The HTML5 input types</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Forms/Other_form_controls">Other form controls</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Forms/Styling_web_forms">Styling web forms</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Forms/Advanced_form_styling">Advanced form styling</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Forms/UI_pseudo-classes">UI pseudo-classes</a></li><li><a href="/pt-BR/docs/Learn/Forms/Form_validation">Form data validation</a></li><li><a href="/pt-BR/docs/Learn/Forms/Sending_and_retrieving_form_data">Sending form data</a></li></ol></details></li><li><details><summary>Advanced web form techniques</summary><ol><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Forms/How_to_build_custom_form_controls">How to build custom form controls</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Forms/Sending_forms_through_JavaScript">Sending forms through JavaScript</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Forms/Property_compatibility_table_for_form_controls">CSS property compatibility table for form controls</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Forms/HTML_forms_in_legacy_browsers">HTML forms in legacy browsers</a></li></ol></details></li><li class="section"><a href="/pt-BR/docs/Learn/Accessibility">Acessibilidade — Faça a Internet usável por qualquer pessoa</a></li><li><details><summary>Guias de acessibilidade</summary><ol><li><a href="/pt-BR/docs/Learn/Accessibility">Accessibility</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Accessibility/What_is_accessibility">What is accessibility?</a></li><li><a href="/pt-BR/docs/Learn/Accessibility/HTML">HTML: Boas práticas em acessibilidade</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Accessibility/CSS_and_JavaScript">CSS and JavaScript accessibility best practices</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Accessibility/WAI-ARIA_basics">WAI-ARIA basics</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Accessibility/Multimedia">Accessible multimedia</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Accessibility/Mobile">Mobile accessibility</a></li><li><a href="/pt-BR/docs/Learn/Accessibility/Accessibility_troubleshooting">Avaliação: solucionando problemas de acessibilidade</a></li></ol></details></li><li class="section"><a href="/pt-BR/docs/Learn/Performance">Performance — Making websites fast and responsive</a></li><li><details><summary>Performance guides</summary><ol><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Performance">Web performance</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Performance/why_web_performance">The "why" of web performance</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Performance/What_is_web_performance">What is web performance?</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Performance/Perceived_performance">Perceived performance</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Performance/Measuring_performance">Measuring performance</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Performance/Multimedia">Multimedia: Images</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Performance/video">Multimedia: video</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Performance/JavaScript">JavaScript performance optimization</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Performance/HTML">HTML performance optimization</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Performance/CSS">CSS performance optimization</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Performance/business_case_for_performance">The business case for web performance</a></li></ol></details></li><li class="section"><a href="/pt-BR/docs/Learn/MathML">MathML — Writing mathematics with MathML</a></li><li><details><summary>MathML first steps</summary><ol><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/MathML/First_steps">MathML first steps</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/MathML/First_steps/Getting_started">Getting started with MathML</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/MathML/First_steps/Text_containers">MathML Text Containers</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/MathML/First_steps/Fractions_and_roots">MathML fractions and roots</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/MathML/First_steps/Scripts">MathML scripted elements</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/MathML/First_steps/Tables">MathML tables</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/MathML/First_steps/Three_famous_mathematical_formulas">Three famous mathematical formulas</a></li></ol></details></li><li class="section"><a href="/pt-BR/docs/Learn/../Games">Games — Developing games for the web</a></li><li><details><summary>Guides and tutorials</summary><ol><li><a href="/pt-BR/docs/Games/Introduction">Introdução ao desenvolvimento de jogos para a Web</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Games/Techniques">Techniques for game development</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Games/Tutorials">Tutorials</a></li><li><a href="/pt-BR/docs/Games/Publishing_games">Publishing games</a></li></ol></details></li><li class="section"><a href="/pt-BR/docs/Learn/Tools_and_testing">Ferramentas e teste</a></li><li><details><summary>Client-side web development tools</summary><ol><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools">Understanding client-side web development tools</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Overview">Client-side tooling overview</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Command_line">Command line crash course</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Package_management">Package management basics</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Introducing_complete_toolchain">Introducing a complete toolchain</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Deployment">Deploying our app</a></li></ol></details></li><li><details><summary>Introduction to client-side frameworks</summary><ol><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Introduction">Introduction to client-side frameworks</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Main_features">Framework main features</a></li></ol></details></li><li><details><summary>React</summary><ol><li><a href="/pt-BR/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/React_getting_started">Começando com React</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/React_todo_list_beginning">Beginning our React todo list</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/React_components">Componentizing our React app</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/React_interactivity_events_state">React interactivity: Events and state</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/React_interactivity_filtering_conditional_rendering">React interactivity: Editing, filtering, conditional rendering</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/React_accessibility">Accessibility in React</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/React_resources">React resources</a></li></ol></details></li><li><details><summary>Ember</summary><ol><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Ember_getting_started">Getting started with Ember</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Ember_structure_componentization">Ember app structure and componentization</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Ember_interactivity_events_state">Ember interactivity: Events, classes and state</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Ember_conditional_footer">Ember Interactivity: Footer functionality, conditional rendering</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Ember_routing">Routing in Ember</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Ember_resources">Ember resources and troubleshooting</a></li></ol></details></li><li><details><summary>Vue</summary><ol><li><a href="/pt-BR/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_getting_started">Iniciando com Vue</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_first_component">Creating our first Vue component</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_rendering_lists">Rendering a list of Vue components</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_methods_events_models">Adding a new todo form: Vue events, methods, and models</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_styling">Styling Vue components with CSS</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_computed_properties">Using Vue computed properties</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_conditional_rendering">Vue conditional rendering: editing existing todos</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_refs_focus_management">Vue refs and lifecycle methods for focus management</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_resources">Vue resources</a></li></ol></details></li><li><details><summary>Svelte</summary><ol><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_getting_started">Getting started with Svelte</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_Todo_list_beginning">Starting our Svelte to-do list app</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_variables_props">Dynamic behavior in Svelte: working with variables and props</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_components">Componentizing our Svelte app</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_reactivity_lifecycle_accessibility">Advanced Svelte: Reactivity, lifecycle, accessibility</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_stores">Working with Svelte stores</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_TypeScript">TypeScript support in Svelte</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_deployment_next">Deployment and next steps</a></li></ol></details></li><li><details><summary>Angular</summary><ol><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Angular_getting_started">Getting started with Angular</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Angular_todo_list_beginning">Beginning our Angular todo list app</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Angular_styling">Styling our Angular app</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Angular_item_component">Creating an item component</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Angular_filtering">Filtering our to-do items</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Angular_building">Building Angular applications and further resources</a></li></ol></details></li><li><details><summary>Git and GitHub</summary><ol><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/GitHub">Git and GitHub</a></li></ol></details></li><li><details><summary>Testes entre navegadores</summary><ol><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing">Cross browser testing</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/Introduction">Introduction to cross-browser testing</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/Testing_strategies">Strategies for carrying out testing</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/HTML_and_CSS">Handling common HTML and CSS problems</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/JavaScript">Handling common JavaScript problems</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/Accessibility">Handling common accessibility problems</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/Feature_detection">Implementing feature detection</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/Automated_testing">Introduction to automated testing</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/Your_own_automation_environment">Setting up your own test automation environment</a></li></ol></details></li><li class="section"><a href="/pt-BR/docs/Learn/Server-side">Programação de servidores de Aplicação</a></li><li><details><summary>Primeiros passos</summary><ol><li><a href="/pt-BR/docs/Learn/Server-side/First_steps">Primeiros passos programando o site no servidor</a></li><li><a href="/pt-BR/docs/Learn/Server-side/First_steps/Introduction">Introdução ao lado servidor</a></li><li><a href="/pt-BR/docs/Learn/Server-side/First_steps/Client-Server_overview">Visão geral do cliente-servidor</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Server-side/First_steps/Web_frameworks">Server-side web frameworks</a></li><li><a href="/pt-BR/docs/Learn/Server-side/First_steps/Website_security">Segurança em aplicação web</a></li></ol></details></li><li><details><summary>Framework Web Django (Python)</summary><ol><li><a href="/pt-BR/docs/Learn/Server-side/Django">Django Web Framework (Python)</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Django/Introduction">Introdução ao Django</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Django/development_environment">Configurando um ambiente de desenvolvimento Django</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Django/Tutorial_local_library_website">Tutorial Django: Website da Biblioteca Local</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Django/skeleton_website">Django Tutorial Parte 2: Criando o "esqueleto" de um site</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Django/Models">Tutorial Django Parte 3: Usando models</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Django/Admin_site">Tutorial Django Parte 4: Django admin site</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Django/Home_page">Django Tutorial Parte 5: Criando nossa home page</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Django/Generic_views">Tutorial Django Parte 6: Lista genérica e detail views</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Django/Sessions">Tutorial Django Parte 7: Sessões</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Django/Authentication">Tutorial Django Parte 8: Autenticação de usuário e permissões</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Django/Forms">Tutorial Django Parte 9: Trabalhando com formulários</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Django/Testing">Tutorial Django Parte 10: Testando uma aplicação web Django</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Django/Deployment">Tutorial Django Parte 11: Hospedando Django para produção</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Django/web_application_security">Segurança de aplicações web Django</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Server-side/Django/django_assessment_blog">Assessment: DIY Django mini blog</a></li></ol></details></li><li><details><summary>Framework Web Express (Node.js/JavaScript)</summary><ol><li><a href="/pt-BR/docs/Learn/Server-side/Express_Nodejs">Express Web Framework (Node.js/JavaScript)</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Express_Nodejs/Introduction">Introdução Express/Node</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Express_Nodejs/development_environment">Configurando o Node como ambiente de desenvolvimento</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Express_Nodejs/Tutorial_local_library_website">Express: Tutorial para criar o site de uma Biblioteca Local</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Express_Nodejs/skeleton_website">Express Tutorial Parte 2: Criando a estrutura do website</a></li><li><a href="/pt-BR/docs/Learn/Server-side/Express_Nodejs/mongoose">Tutorial Express Parte 3: Usando um banco de dados (com Mongoose)</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Server-side/Express_Nodejs/routes">Express Tutorial Part 4: Routes and controllers</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Server-side/Express_Nodejs/Displaying_data">Express Tutorial Part 5: Displaying library data</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Server-side/Express_Nodejs/forms">Express Tutorial Part 6: Working with forms</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Server-side/Express_Nodejs/deployment">Express Tutorial Part 7: Deploying to production</a></li></ol></details></li><li class="section"><a href="/pt-BR/docs/Learn/Common_questions">Mais recursos</a></li><li><details><summary>Questões gerais</summary><ol><li><a href="/pt-BR/docs/Learn/Common_questions">Questões comuns</a></li><li><a href="/pt-BR/docs/Learn/HTML/Howto">Use HTML para resolver problemas comuns</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/CSS/Howto">Use CSS to solve common problems</a></li><li><a href="/pt-BR/docs/Learn/JavaScript/Howto">Solve common problems in your JavaScript code</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Common_questions/Web_mechanics">Web mechanics</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Common_questions/Tools_and_setup">Tools and setup</a></li><li><a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Learn/Common_questions/Design_and_accessibility">Design and accessibility</a></li></ol></details></li></ol></div></div><section class="place side"></section></nav></aside><div class="toc-container"><aside class="toc"><nav><div class="document-toc-container"><section class="document-toc"><header><h2 class="document-toc-heading">Neste artigo</h2></header><ul class="document-toc-list"><li class="document-toc-item "><a class="document-toc-link" href="#o_que_são_apis">O que são APIs?</a></li><li class="document-toc-item "><a class="document-toc-link" href="#o_que_as_apis_podem_fazer">O que as APIs podem fazer?</a></li><li class="document-toc-item "><a class="document-toc-link" href="#como_as_apis_funcionam">Como as APIs funcionam?</a></li><li class="document-toc-item "><a class="document-toc-link" href="#resumo">Resumo</a></li></ul></section></div></nav></aside><section class="place side"></section></div></div><main id="content" class="main-content "><article class="main-page-content" lang="pt-BR"><header><h1>Introdução às Web APIs</h1></header><div class="section-content"><ul class="prev-next"> <li><a class="button secondary" href="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs"><span class="button-wrap"> Menu: APIs web do lado cliente</span></a></li> <li><a class="button secondary" href="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Manipulating_documents"><span class="button-wrap"> Próxima </span></a></li> </ul> <p>Primeiro, vamos ver as APIs a partir de um nível mais alto: o que são, como funcionam, como usá-las em seu código e como são estruturadas? Ainda, vamos entender quais são as principais classes de APIs e quais usos elas possuem.</p> <figure class="table-container"><table class="learn-box standard-table"> <tbody> <tr> <th scope="row">Pré-requisitos:</th> <td> <p> Conhecimentos básicos de computação, <a href="/pt-BR/docs/Learn/HTML">HTML</a>, <a href="/pt-BR/docs/Learn/CSS">CSS</a> e JavaScript (veja <a href="/pt-BR/docs/Learn/JavaScript/First_steps">primeiros passos</a>, <a href="/pt-BR/docs/Learn/JavaScript/Building_blocks">elementos construtivos</a> e <a href="/pt-BR/docs/Learn/JavaScript/Objects">introdução a objetos</a>). </p> </td> </tr> <tr> <th scope="row">Objetivo:</th> <td> Familiarizar-se com APIs, o que elas podem fazer, e como usá-las em seu código. </td> </tr> </tbody> </table></figure></div><section aria-labelledby="o_que_são_apis"><h2 id="o_que_são_apis"><a href="#o_que_são_apis">O que são APIs?</a></h2><div class="section-content"><p>As APIs (Application Programming Interfaces) são construções disponíveis nas linguagens de programação que permitem a desenvolvedores criar funcionalidades complexas mais facilmente. Tais construções abstraem o código mais complexo, proporcionando o uso de sintaxes mais simples em seu lugar.</p> <p>Pense no seguinte exemplo: o uso de energia elétrica em sua casa ou apartamento. Quando você deseja utilizar um eletrodoméstico, você precisa somente ligar o aparelho na tomada. Não é preciso conectar diretamente o fio do aparelho diretamente na caixa de luz. Isso seria, além de muito ineficiente, difícil e perigoso de ser feito (caso você não seja eletricista).</p> <p> <img src="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction/plug-socket.png" alt="" width="700" height="472" loading="lazy"> </p> <p><em>Fonte da imagem: <a href="https://www.flickr.com/photos/easy-pics/9518184890/in/photostream/lightbox/" class="external" target="_blank">Overloaded plug socket</a> por <a href="https://www.flickr.com/photos/easy-pics/" class="external" target="_blank">The Clear Communication People</a>, retirado do Flickr.</em></p> <p>Da mesma forma, caso você queira programar gráficos em 3D, é muito mais fácil usar uma API escrita em linguagem de alto nível como JavaScript ou Python, do que escrever em código de mais baixo nível (C ou C++) que controla diretamente a GPU ou outras funções gráficas.</p> <div class="notecard note"> <p><strong>Nota:</strong> para mais informações, consulte o <a href="/pt-BR/docs/Glossary/API">termo API</a> no glossário.</p> </div></div></section><section aria-labelledby="apis_javascript_client-side"><h3 id="apis_javascript_client-side"><a href="#apis_javascript_client-side">APIs JavaScript client-side</a></h3><div class="section-content"><p>A linguagem JavaScript, especialmente client-side, possui diversas APIs disponíveis. Elas não fazem parte da linguagem em si, mas são escritas sobre o <em>core</em> da linguagem JavaScript, fornecendo superpoderes para serem utilizados em seu código. Geralmente, tais APIs fazem parte de uma das seguintes categorias:</p> <ul> <li><strong>APIs de navegadores:</strong> fazem parte do seu navegador web, sendo capazes de expor dados do navegador e do ambiente ao redor do computador circundante, além de fazer coisas úteis com esses dados. Por exemplo, a <a href="/pt-BR/docs/Web/API/Web_Audio_API">API Web Áudio</a> fornece construções JavaScript simples para manipular áudio em seu navegador - pegar uma faixa de áudio, alterar o volume dela, aplicar efeitos, etc. Por trás dos panos, o navegador utiliza códigos complexos de baixo nível (ex: C++) para realizar o processamento de áudio de fato. Como foi dito anteriormente, essa complexidade toda é abstraída de você pela API.</li> <li><strong>APIs de terceiros:</strong> geralmente, não fazem parte do navegador e você precisa recuperar seu código e suas informações de outro local da web. A <a href="https://developer.twitter.com/en/docs" class="external" target="_blank">API do Twitter</a>, por exemplo, permite mostrar os seus últimos tweets no seu site. Ela fornece um conjunto de construções especiais para ser usado de maneira a consultar o serviço do Twitter e retornar informações específicas.</li> </ul> <p> <img src="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction/browser.png" alt="" width="815" height="511" loading="lazy"> </p></div></section><section aria-labelledby="relacionamento_entre_javascript_apis_e_outras_ferramentas_javascript"><h3 id="relacionamento_entre_javascript_apis_e_outras_ferramentas_javascript"><a href="#relacionamento_entre_javascript_apis_e_outras_ferramentas_javascript">Relacionamento entre JavaScript, APIs, e outras ferramentas JavaScript</a></h3><div class="section-content"><p>Na seção anterior, abordamos as APIs JavaScript client-side e como elas se relacionam com a linguagem JavaScript. Esse ponto merece uma revisão e também uma breve menção de como outras ferramentas JavaScript encaixam-se nesse contexto:</p> <ul> <li>JavaScript — linguagem de alto nível, embutida em navegadores, que permite implementar funcionalidades em páginas web/aplicativos. A linguagem também está disponível em outros ambientes de programação, tais como o <a href="/pt-BR/docs/Learn/Server-side/Express_Nodejs/Introduction">Node</a>.</li> <li>APIs de navegadores — construções presentes no navegador, as quais são baseadas em linguagem JavaScript e permitem a implementação de funcionalidades de uma maneira mais fácil.</li> <li>APIs de terceiros — construções presentes em plataformas de terceiros (ex: Twitter, Facebook), que permitem o uso de alguma funcionalidade da plataforma em suas páginas na web. Um exemplo é a possibilidade de mostrar os últimos tweets em sua página.</li> <li>Bibliotecas JavaScript — em geral, um ou mais arquivos JavaScript contendo <a href="/pt-BR/docs/Learn/JavaScript/Building_blocks/Functions#fun%c3%a7%c3%b5es_personalizadas">funções personalizadas</a>, as quais podem ser usadas em sua página web para acelerar ou permitir escrever funcionalidades comuns. Exemplos: jQuery, Mootools e React.</li> <li>Frameworks JavaScript — uma evolução das bibliotecas. Frameworks JavaScript (ex: Angular e Ember), normalmente, são pacotes de tecnologias HTML, CSS, JavaScript e outras, que você instala e usa para escrever uma aplicação web completa do zero. A principal diferença entre uma biblioteca e um framework é a inversão de controle ("Inversion of Control"). Quando um método de uma biblioteca é chamado, a pessoa desenvolvedora está no controle. Em um framework, o controle inverte-se: é o framework que chama o código da pessoa desenvolvedora.</li> </ul></div></section><section aria-labelledby="o_que_as_apis_podem_fazer"><h2 id="o_que_as_apis_podem_fazer"><a href="#o_que_as_apis_podem_fazer">O que as APIs podem fazer?</a></h2><div class="section-content"><p>Existem muitas APIs disponíveis, nos navegadores modernos, que permitem uma liberdade de ação na hora de codar. Você pode conferir isso na <a href="/pt-BR/docs/Web/API">página de referência das APIs da MDN</a>.</p></div></section><section aria-labelledby="apis_comuns_de_navegadores"><h3 id="apis_comuns_de_navegadores"><a href="#apis_comuns_de_navegadores">APIs comuns de navegadores</a></h3><div class="section-content"><p>As categorias mais comuns de APIs de navegadores que você irá utilizar (e que veremos em detalhes neste módulo), são:</p> <ul> <li><strong>APIs para manipular documentos</strong> carregados no navegador. O exemplo mais óbvio é a <a href="/pt-BR/docs/Web/API/Document_Object_Model">API DOM (Document Object Model)</a>, que permite manipular HTML e CSS — criando, removendo a alterando o HTML, aplicando dinamicamente novos estilos a sua página, etc. Toda vez que você vê uma janela pop-up em uma página, ou um novo conteúdo é mostrado, o DOM está em ação. Para saber mais sobre estes tipos de API, leia <a href="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Manipulating_documents">Manipulando documentos</a>.</li> <li><strong>APIs</strong> <strong>que buscam dados no servidor</strong> para atualizar pequenas seções da página, por conta própria, são bastante usadas. Isso, a princípio, parece ser um detalhe pequeno, mas tem um impacto enorme na performance e no comportamento dos sites. Se você precisa atualizar a cotação de uma ação ou listar novas histórias disponíveis, a possibilidade de fazer isso instantaneamente sem precisar atualizar a página dá a impressão de um site muito mais responsivo. Entre as APIs que tornam isso possível, podemos destacar o <a href="/pt-BR/docs/Web/API/XMLHttpRequest"><code>XMLHttpRequest</code></a> e a <a href="/pt-BR/docs/Web/API/Fetch_API">API Fetch</a>. Você pode também encontrar o termo <strong>Ajax</strong>, que descreve essa técnica. Para saber mais sobre essas APIs, leia <a href="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Fetching_data">Fetching data from the server</a>.</li> <li><strong>APIs para desenhar e manipular elementos gráficos</strong> são completamente suportados nos browsers — os mais comuns são <a href="/pt-BR/docs/Web/API/Canvas_API">Canvas</a> e <a href="/pt-BR/docs/Web/API/WebGL_API">WebGL</a>, que possibilitam que você atualize os dados dos pixels em um elemento HTML de maneira programática. <a href="/pt-BR/docs/Web/HTML/Element/canvas"><code><canvas></code></a> elemento para criar cenas 2d e 3d. Por exemplo, você poderia dezenhar formas como retangulos e circulos, importar uma imagem para o canvas, e aplicar um filtro para sepia ou grayscale usando o Canvas API, ou criar uma complexa cena 3d com brilho e texturas usando WebGL. Essas APIs são frequentemente combinar com APIs para criar loops de animações(como <a href="/pt-BR/docs/Web/API/Window/requestAnimationFrame"><code>window.requestAnimationFrame()</code></a>) e outros para constantemente lançar cenas like como cartoons e jogos.</li> <li><strong><a href="/pt-BR/docs/Apps/Fundamentals/Audio_and_video_delivery">Audio and Video APIs</a></strong> como <a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Web/API/HTMLMediaElement"><code>HTMLMediaElement</code></a>, a <a href="/pt-BR/docs/Web/API/Web_Audio_API">Web Audio API</a>, e <a href="/pt-BR/docs/Web/API/WebRTC_API">WebRTC</a> permiten a você fazer coisas realmente interessantes com multimedia como a criação personalizada controles de UI para executar audio e video, exibindo faixas de texto como legendas e legendas ocultas junto com seus vídeos, capturando vídeo de sua câmera da web para ser manipulado por meio de uma tela (veja acima) ou exibido no computador de outra pessoa em uma webconferência,ou adicionar efeitos às trilhas de áudio (como ganho, distorção, panorâmica, etc.).</li> <li><strong>Device APIs</strong> São basicamente APIs para manipulação e recuperação de dados de hardware de dispositivo moderno de uma forma que seja útil para aplicativos da web.Já falamos sobre a Geolocation API acessando o dispositivo dados de localização para que você possa marcar sua posição em um mapa.Outros exemplos incluem informar ao usuário que uma atualização útil está disponível em um aplicativo da web por meio de notificações do sistema(Veja em <a href="/en-US/docs/Web/API/Notifications_API" class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento">Notifications API</a>)ou hardware de vibração(Veja em <a href="/en-US/docs/Web/API/Vibration_API" class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento">Vibration API</a>).</li> <li><strong>Client-side storage APIs</strong> estão se tornando muito mais difundidos em navegadores da web - a capacidade de armazenar dados no lado do cliente é muito útil se você quer criar um app que vai salvar seu estado entre carregamentos de página, e talvez até funcione quando o dispositivo estiver offline. Existem várias opções disponíveis, por exemplo, armazenamento simples de nome / valor com o <a href="/pt-BR/docs/Web/API/Web_Storage_API">Web Storage API</a>, e armazenamento de dados tabulares mais complexos com o <a href="/pt-BR/docs/Web/API/IndexedDB_API">IndexedDB API</a>.</li> </ul></div></section><section aria-labelledby="apis_comuns_de_terceiros"><h3 id="apis_comuns_de_terceiros"><a href="#apis_comuns_de_terceiros">APIs comuns de terceiros</a></h3><div class="section-content"><p>APIs de terceiros são bastante variadas. Dentre as mais populares, que você eventualmente irá utilizar em algum momento, podermos destacar:</p> <ul> <li>A <a href="https://dev.twitter.com/overview/documentation" class="external" target="_blank">Twitter API</a>, que permite coisas como mostrar seu últimos tweets no seu website.</li> <li>O <a href="https://developers.google.com/maps/" class="external" target="_blank">Google Maps API</a> permite que você faça todo tipo de coisa com mapas nas suas páginas web (funnily enough, it also powers Google Maps). This is now an entire suite of APIs, which handle a wide variety of tasks, as evidenced by the <a href="https://developers.google.com/maps/documentation/api-picker" class="external" target="_blank">Google Maps API Picker</a>.</li> <li>The <a href="https://developers.facebook.com/docs/" class="external" target="_blank">Facebook suite of APIs</a> enables you to use various parts of the Facebook ecosystem to benefit your app, for example by providing app login using Facebook login, accepting in-app payments, rolling out targetted ad campaigns, etc.</li> <li>The <a href="https://developers.google.com/youtube/" class="external" target="_blank">YouTube API</a>, which allows you to embed YouTube videos on your site, search YouTube, build playlists, and more.</li> <li>The <a href="https://www.twilio.com/" class="external" target="_blank">Twilio API</a>, which provides a framework for building voice and video call functionality into your app, sending SMS/MMS from your apps, and more.</li> </ul> <div class="notecard note"> <p><strong>Nota:</strong> Você pode encontrar informações sobre muitas outras APIs de terceiros no <a href="http://www.programmableweb.com/category/all/apis" class="external" target="_blank">Programmable Web API directory</a>.</p> </div></div></section><section aria-labelledby="como_as_apis_funcionam"><h2 id="como_as_apis_funcionam"><a href="#como_as_apis_funcionam">Como as APIs funcionam?</a></h2><div class="section-content"><p>APIs JavaScript possuem pequenas diferenças mas, em geral, possuem funcionalidades em comum e operam de maneira semelhante.</p></div></section><section aria-labelledby="elas_são_baseadas_em_objetos"><h3 id="elas_são_baseadas_em_objetos"><a href="#elas_são_baseadas_em_objetos">Elas são baseadas em objetos</a></h3><div class="section-content"><p>Your code interacts with APIs using one or more <a href="/pt-BR/docs/Learn/JavaScript/Objects">JavaScript objects</a>, which serve as containers for the data the API uses (contained in object properties), and the functionality the API makes available (contained in object methods).</p> <div class="notecard note"> <p><strong>Nota:</strong> If you are not already familiar with how objects work, you should go back and work through our <a href="/pt-BR/docs/Learn/JavaScript/Objects">JavaScript objects</a> module before continuing.</p> </div> <p>Let's return to the example of the Geolocation API — this is a very simple API that consists of a few simple objects:</p> <ul> <li><a href="/pt-BR/docs/Web/API/Geolocation"><code>Geolocation</code></a>, which contains three methods for controlling the retrieval of geodata.</li> <li><a href="/pt-BR/docs/Web/API/GeolocationPosition"><code>Position</code></a>, which represents the position of a device at a given time — this contains a <a href="/pt-BR/docs/Web/API/GeolocationCoordinates"><code>Coordinates</code></a> object that contains the actual position information, plus a timestamp representing the given time.</li> <li><a href="/pt-BR/docs/Web/API/GeolocationCoordinates"><code>Coordinates</code></a>, which contains a whole lot of useful data on the device position, including latitude and longitude, altitude, velocity and direction of movement, and more.</li> </ul> <p>So how do these objects interact? If you look at our <a href="https://github.com/mdn/learning-area/blob/master/javascript/apis/introduction/maps-example.html" class="external" target="_blank">maps-example.html</a> example (<a href="https://mdn.github.io/learning-area/javascript/apis/introduction/maps-example.html" class="external" target="_blank">see it live also</a>), you'll see the following code:</p> <div class="code-example"><div class="example-header"><span class="language-name">js</span></div><pre class="brush: js notranslate"><code>navigator.geolocation.getCurrentPosition(function (position) { var latlng = new google.maps.LatLng( position.coords.latitude, position.coords.longitude, ); var myOptions = { zoom: 8, center: latlng, mapTypeId: google.maps.MapTypeId.TERRAIN, disableDefaultUI: true, }; var map = new google.maps.Map( document.querySelector("#map_canvas"), myOptions, ); }); </code></pre></div> <div class="notecard note"> <p><strong>Nota:</strong> When you first load up the above example, you should be given a dialog box asking if you are happy to share your location with this application (see the <a href="#they_have_additional_security_mechanisms_where_appropriate">They have additional security mechanisms where appropriate</a> section later in the article). You need to agree to this to be able to plot your location on the map. If you still can't see the map, you may need to set your permissions manually; you can do this in various ways depending on what browser you are using; for example in Firefox go to > <em>Tools</em> > <em>Page Info</em> > <em>Permissions</em>, then change the setting for <em>Share Location</em>; in Chrome go to <em>Settings</em> > <em>Privacy</em> > <em>Show advanced settings</em> > <em>Content settings</em> then change the settings for <em>Location</em>.</p> </div> <p>We first want to use the <a href="/pt-BR/docs/Web/API/Geolocation/getCurrentPosition"><code>Geolocation.getCurrentPosition()</code></a> method to return the current location of our device. The browser's <a href="/pt-BR/docs/Web/API/Geolocation"><code>Geolocation</code></a> object is accessed by calling the <a href="/pt-BR/docs/Web/API/Navigator/geolocation"><code>Navigator.geolocation</code></a> property, so we start off by using</p> <div class="code-example"><div class="example-header"><span class="language-name">js</span></div><pre class="brush: js notranslate"><code>navigator.geolocation.getCurrentPosition(function(position) { ... }); </code></pre></div> <p>Isso é equivalente a fazer algo como</p> <div class="code-example"><div class="example-header"><span class="language-name">js</span></div><pre class="brush: js notranslate"><code>var myGeo = navigator.geolocation; myGeo.getCurrentPosition(function(position) { ... }); </code></pre></div> <p>But we can use the dot syntax to chain our property/method access together, reducing the number of lines we have to write.</p> <p>The <a href="/pt-BR/docs/Web/API/Geolocation/getCurrentPosition"><code>Geolocation.getCurrentPosition()</code></a> method only has a single mandatory parameter, which is an anonymous function that will run when the device's current position has been successfully retrieved. This function itself has a parameter, which contains a <a href="/pt-BR/docs/Web/API/GeolocationPosition"><code>Position</code></a> object representing the current position data.</p> <div class="notecard note"> <p><strong>Nota:</strong> A function that is taken by another function as an argument is called a <a href="/pt-BR/docs/Glossary/Callback_function">callback function</a>.</p> </div> <p>This pattern of invoking a function only when an operation has been completed is very common in JavaScript APIs — making sure one operation has completed before trying to use the data the operation returns in another operation. These are called <strong><a href="/pt-BR/docs/Glossary/Asynchronous">asynchronous</a> operations</strong>. Because getting the device's current position relies on an external component (the device's GPS or other geolocation hardware), we can't guarantee that it will be done in time to just immediately use the data it returns. Therefore, something like this wouldn't work:</p> <div class="code-example"><div class="example-header"><span class="language-name">js</span></div><pre class="brush: js example-bad notranslate"><code>var position = navigator.geolocation.getCurrentPosition(); var myLatitude = position.coords.latitude; </code></pre></div> <p>If the first line had not yet returned its result, the second line would throw an error, because the position data would not yet be available. For this reason, APIs involving asynchronous operations are designed to use <a href="/pt-BR/docs/Glossary/Callback_function">callback function</a>s, or the more modern system of <a href="/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Promise">Promises</a>, which were made available in ECMAScript 6 and are widely used in newer APIs.</p> <p>We are combining the Geolocation API with a third party API — the Google Maps API — which we are using to plot the location returned by <code>getCurrentPosition()</code> on a Google Map. We make this API available on our page by linking to it — you'll find this line in the HTML:</p> <div class="code-example"><div class="example-header"><span class="language-name">html</span></div><pre class="brush: html notranslate"><code><script type="text/javascript" src="https://maps.google.com/maps/api/js?key=AIzaSyDDuGt0E5IEGkcE6ZfrKfUtE9Ko_de66pA"></script> </code></pre></div> <p>To use the API, we first create a <code>LatLng</code> object instance using the <code>google.maps.LatLng()</code> constructor, which takes our geolocated <a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Web/API/GeolocationCoordinates/latitude"><code>Coordinates.latitude</code></a> and <a class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento" href="/en-US/docs/Web/API/GeolocationCoordinates/longitude"><code>Coordinates.longitude</code></a> values as parameters:</p> <div class="code-example"><div class="example-header"><span class="language-name">js</span></div><pre class="brush: js notranslate"><code>var latlng = new google.maps.LatLng( position.coords.latitude, position.coords.longitude, ); </code></pre></div> <p>This object is itself set as the value of the <code>center</code> property of an options object that we've called <code>myOptions</code>. We then create an object instance to represent our map by calling the <code>google.maps.Map()</code> constructor, passing it two parameters — a reference to the <a href="/pt-BR/docs/Web/HTML/Element/div"><code><div></code></a> element we want to render the map on (with an ID of <code>map_canvas</code>), and the options object we defined just above it.</p> <div class="code-example"><div class="example-header"><span class="language-name">js</span></div><pre class="brush: js notranslate"><code>var myOptions = { zoom: 8, center: latlng, mapTypeId: google.maps.MapTypeId.TERRAIN, disableDefaultUI: true, }; var map = new google.maps.Map(document.querySelector("#map_canvas"), myOptions); </code></pre></div> <p>With this done, our map now renders.</p> <p>This last block of code highlights two common patterns you'll see across many APIs. First of all, API objects commonly contain constructors, which are invoked to create instances of those objects that you'll use to write your program. Second, API objects often have several options available that can be tweaked to get the exact environment you want for your program. API constructors commonly accept options objects as parameters, which is where you'd set such options.</p> <div class="notecard note"> <p><strong>Nota:</strong> Don't worry if you don't understand all the details of this example immediately. We'll cover using third party APIs in a lot more detail in a future article.</p> </div></div></section><section aria-labelledby="possuem_pontos_de_entrada_reconhecíveis"><h3 id="possuem_pontos_de_entrada_reconhecíveis"><a href="#possuem_pontos_de_entrada_reconhecíveis">Possuem pontos de entrada reconhecíveis</a></h3><div class="section-content"><p>When using an API, you should make sure you know where the entry point is for the API. In The Geolocation API, this is pretty simple — it is the <a href="/pt-BR/docs/Web/API/Navigator/geolocation"><code>Navigator.geolocation</code></a> property, which returns the browser's <a href="/pt-BR/docs/Web/API/Geolocation"><code>Geolocation</code></a> object that all the useful geolocation methods are available inside.</p> <p>The Document Object Model (DOM) API has an even simpler entry point — its features tend to be found hanging off the <a href="/pt-BR/docs/Web/API/Document"><code>Document</code></a> object, or an instance of an HTML element that you want to affect in some way, for example:</p> <div class="code-example"><div class="example-header"><span class="language-name">js</span></div><pre class="brush: js notranslate"><code>var em = document.createElement("em"); // create a new em element var para = document.querySelector("p"); // reference an existing p element em.textContent = "Hello there!"; // give em some text content para.appendChild(em); // embed em inside para </code></pre></div> <p>Other APIs have slightly more complex entry points, often involving creating a specific context for the API code to be written in. For example, the Canvas API's context object is created by getting a reference to the <a href="/pt-BR/docs/Web/HTML/Element/canvas"><code><canvas></code></a> element you want to draw on, and then calling its <a href="/pt-BR/docs/Web/API/HTMLCanvasElement/getContext"><code>HTMLCanvasElement.getContext()</code></a> method:</p> <div class="code-example"><div class="example-header"><span class="language-name">js</span></div><pre class="brush: js notranslate"><code>var canvas = document.querySelector("canvas"); var ctx = canvas.getContext("2d"); </code></pre></div> <p>Anything that we want to do to the canvas is then achieved by calling properties and methods of the content object (which is an instance of <a href="/pt-BR/docs/Web/API/CanvasRenderingContext2D"><code>CanvasRenderingContext2D</code></a>), for example:</p> <div class="code-example"><div class="example-header"><span class="language-name">js</span></div><pre class="brush: js notranslate"><code>Ball.prototype.draw = function () { ctx.beginPath(); ctx.fillStyle = this.color; ctx.arc(this.x, this.y, this.size, 0, 2 * Math.PI); ctx.fill(); }; </code></pre></div> <div class="notecard note"> <p><strong>Nota:</strong> You can see this code in action in our <a href="https://github.com/mdn/learning-area/blob/master/javascript/apis/introduction/bouncing-balls.html" class="external" target="_blank">bouncing balls demo</a> (see it <a href="https://mdn.github.io/learning-area/javascript/apis/introduction/bouncing-balls.html" class="external" target="_blank">running live</a> also).</p> </div></div></section><section aria-labelledby="usam_eventos_para_lidar_com_mudanças_de_estado"><h3 id="usam_eventos_para_lidar_com_mudanças_de_estado"><a href="#usam_eventos_para_lidar_com_mudanças_de_estado">Usam eventos para lidar com mudanças de estado</a></h3><div class="section-content"><p>We already discussed events earlier on in the course, in our <a href="/pt-BR/docs/Learn/JavaScript/Building_blocks/Events">Introduction to events</a> article — this article looks in detail at what client-side web events are and how they are used in your code. If you are not already familiar with how client-side web API events work, you should go and read this article first before continuing.</p> <p>Some web APIs contain no events, but some contain a number of events. The handler properties that allow us to run functions when events fire are generally listed in our reference material in separate "Event handlers" sections. As a simple example, instances of the <a href="/pt-BR/docs/Web/API/XMLHttpRequest"><code>XMLHttpRequest</code></a> object (each one represents an HTTP request to the server to retrieve a new resource of some kind) have a number of events available on them, for example the <code>load</code> event is fired when a response has been successfully returned containing the requested resource, and it is now available.</p> <p>O código seguinte fornece um exemplo simples de como isso seria utilizado:</p> <div class="code-example"><div class="example-header"><span class="language-name">js</span></div><pre class="brush: js notranslate"><code>var requestURL = "https://mdn.github.io/learning-area/javascript/oojs/json/superheroes.json"; var request = new XMLHttpRequest(); request.open("GET", requestURL); request.responseType = "json"; request.send(); request.onload = function () { var superHeroes = request.response; populateHeader(superHeroes); showHeroes(superHeroes); }; </code></pre></div> <div class="notecard note"> <p><strong>Nota:</strong> You can see this code in action in our <a href="https://github.com/mdn/learning-area/blob/master/javascript/apis/introduction/ajax.html" class="external" target="_blank">ajax.html</a> example (<a href="https://mdn.github.io/learning-area/javascript/apis/introduction/ajax.html" class="external" target="_blank">see it live</a> also).</p> </div> <p>The first five lines specify the location of resource we want to fetch, create a new instance of a request object using the <code>XMLHttpRequest()</code> constructor, open an HTTP <code>GET</code> request to retrieve the specified resource, specify that the response should be sent in JSON format, then send the request.</p> <p>The <code>onload</code> handler function then specifies what we do with the response. We know the response will be successfully returned and available after the load event has required (unless an error occurred), so we save the response containing the returned JSON in the <code>superHeroes</code> variable, then pass it to two different functions for further processing.</p></div></section><section aria-labelledby="possuem_mecanismos_de_segurança_adicionais_quando_apropriado"><h3 id="possuem_mecanismos_de_segurança_adicionais_quando_apropriado"><a href="#possuem_mecanismos_de_segurança_adicionais_quando_apropriado">Possuem mecanismos de segurança adicionais, quando apropriado</a></h3><div class="section-content"><p>WebAPI features are subject to the same security considerations as JavaScript and other web technologies (for example <a href="/en-US/docs/Web/Security/Same-origin_policy" class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento">same-origin policy</a>), but they sometimes have additional security mechanisms in place. For example, some of the more modern WebAPIs will only work on pages served over HTTPS due to them transmitting potentially sensitive data (examples include <a href="/pt-BR/docs/Web/API/Service_Worker_API">Service Workers</a> and <a href="/pt-BR/docs/Web/API/Push_API">Push</a>).</p> <p>In addition, some WebAPIs request permission to be enabled from the user once calls to them are made in your code. As an example, you may have noticed a dialog like the following when loading up our earlier <a href="/pt-BR/docs/Web/API/Geolocation">Geolocation</a> example:</p> <p> <img src="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction/location-permission.png" alt="" width="413" height="188" loading="lazy"> </p> <p>The <a href="/en-US/docs/Web/API/Notifications_API" class="only-in-en-us" title="Esta página está disponível apenas em inglês no momento">Notifications API</a> asks for permission in a similar fashion:</p> <p> <img src="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction/notification-permission.png" alt="" width="404" height="185" loading="lazy"> </p> <p>These permission prompts are given to users for security — if they weren't in place, then sites could start secretly tracking your location without you knowing it, or spamming you with a lot of annoying notifications.</p></div></section><section aria-labelledby="resumo"><h2 id="resumo"><a href="#resumo">Resumo</a></h2><div class="section-content"><p>Ao chegar aqui, você deve ter uma boa ideia do que são APIs, como funcionam e o que você pode fazer com elas em seu código JavaScript. Além do mais, você deve estar ansioso(a) para colocar a mão na massa e trabalhar com APIs. Na sequência, iremos ver como manipular documentos com o DOM (Document Object Model).</p><ul class="prev-next"> <li><a class="button secondary" href="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs"><span class="button-wrap"> Menu: APIs web do lado cliente</span></a></li> <li><a class="button secondary" href="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Manipulating_documents"><span class="button-wrap"> Próxima </span></a></li> </ul></div></section></article><aside class="article-footer"><div class="article-footer-inner"><div class="svg-container"><svg xmlns="http://www.w3.org/2000/svg" width="162" height="162" viewBox="0 0 162 162" fill="none" role="none"><mask id="b" fill="#fff"><path d="M97.203 47.04c8.113-7.886 18.004-13.871 28.906-17.492a78 78 0 0 1 33.969-3.39c11.443 1.39 22.401 5.295 32.024 11.411s17.656 14.28 23.476 23.86c5.819 9.579 9.269 20.318 10.083 31.385a69.85 69.85 0 0 1-5.387 32.44c-4.358 10.272-11.115 19.443-19.747 26.801-8.632 7.359-18.908 12.709-30.034 15.637l-6.17-21.698c7.666-2.017 14.746-5.703 20.694-10.773 5.948-5.071 10.603-11.389 13.606-18.467a48.14 48.14 0 0 0 3.712-22.352c-.561-7.625-2.938-15.025-6.948-21.625s-9.544-12.226-16.175-16.44-14.181-6.904-22.065-7.863a53.75 53.75 0 0 0-23.405 2.336c-7.513 2.495-14.327 6.62-19.918 12.053z"></path></mask><path stroke="url(#a)" stroke-dasharray="6, 6" stroke-width="2" d="M97.203 47.04c8.113-7.886 18.004-13.871 28.906-17.492a78 78 0 0 1 33.969-3.39c11.443 1.39 22.401 5.295 32.024 11.411s17.656 14.28 23.476 23.86c5.819 9.579 9.269 20.318 10.083 31.385a69.85 69.85 0 0 1-5.387 32.44c-4.358 10.272-11.115 19.443-19.747 26.801-8.632 7.359-18.908 12.709-30.034 15.637l-6.17-21.698c7.666-2.017 14.746-5.703 20.694-10.773 5.948-5.071 10.603-11.389 13.606-18.467a48.14 48.14 0 0 0 3.712-22.352c-.561-7.625-2.938-15.025-6.948-21.625s-9.544-12.226-16.175-16.44-14.181-6.904-22.065-7.863a53.75 53.75 0 0 0-23.405 2.336c-7.513 2.495-14.327 6.62-19.918 12.053z" mask="url(#b)" style="stroke:url(#a)" transform="translate(-63.992 -25.587)"></path><ellipse cx="8.066" cy="111.597" fill="var(--background-tertiary)" rx="53.677" ry="53.699" transform="matrix(.71707 -.697 .7243 .6895 0 0)"></ellipse><g clip-path="url(#c)" transform="translate(-63.992 -25.587)"><path fill="#9abff5" d="m144.256 137.379 32.906 12.434a4.41 4.41 0 0 1 2.559 5.667l-9.326 24.679a4.41 4.41 0 0 1-5.667 2.559l-8.226-3.108-2.332 6.17c-.466 1.233-.375 1.883-1.609 1.417l-2.253-.527c-.411-.155-.95-.594-1.206-1.161l-4.734-10.484-12.545-4.741a4.41 4.41 0 0 1-2.559-5.667l9.325-24.679a4.41 4.41 0 0 1 5.667-2.559m9.961 29.617 8.227 3.108 3.264-8.638-.498-6.768-4.113-1.555.548 7.258-4.319-1.632zm-12.339-4.663 8.226 3.108 3.264-8.637-.498-6.769-4.113-1.554.548 7.257-4.319-1.632z"></path></g><g clip-path="url(#d)" transform="translate(-63.992 -25.587)"><path fill="#81b0f3" d="M135.35 60.136 86.67 41.654c-3.346-1.27-7.124.428-8.394 3.775L64.414 81.938c-1.27 3.347.428 7.125 3.774 8.395l12.17 4.62-3.465 9.128c-.693 1.826-1.432 2.457.394 3.15l3.014 1.625c.609.231 1.637.274 2.477-.104l15.53-6.983 18.56 7.047c3.346 1.27 7.124-.428 8.395-3.775l13.862-36.51c1.27-3.346-.428-7.124-3.775-8.395M95.261 83.207l-12.17-4.62 4.852-12.779 7.19-7.017 6.085 2.31-7.725 7.51 6.389 2.426zm18.255 6.93-12.17-4.62 4.852-12.778 7.189-7.017 6.085 2.31-7.725 7.51 6.39 2.426z"></path></g><defs><clipPath id="c"><path fill="#fff" d="m198.638 146.586-65.056-24.583-24.583 65.057 65.056 24.582z"></path></clipPath><clipPath id="d"><path fill="#fff" d="m66.438 14.055 96.242 36.54-36.54 96.243-96.243-36.54z"></path></clipPath><linearGradient id="a" x1="97.203" x2="199.995" y1="47.04" y2="152.793" gradientUnits="userSpaceOnUse"><stop stop-color="#086DFC"></stop><stop offset="0.246" stop-color="#2C81FA"></stop><stop offset="0.516" stop-color="#5497F8"></stop><stop offset="0.821" stop-color="#80B0F6"></stop><stop offset="1" stop-color="#9ABFF5"></stop></linearGradient></defs></svg></div><h2>Help improve MDN</h2><fieldset class="feedback"><label>Was this page helpful to you?</label><div class="button-container"><button type="button" class="button primary has-icon yes"><span class="button-wrap"><span class="icon icon-thumbs-up "></span>Yes</span></button><button type="button" class="button primary has-icon no"><span class="button-wrap"><span class="icon icon-thumbs-down "></span>No</span></button></div></fieldset><a class="contribute" href="https://github.com/mdn/translated-content/blob/main/CONTRIBUTING.md" title="This will take you to our contribution guidelines on GitHub." target="_blank" rel="noopener noreferrer">Learn how to contribute</a>.<p class="last-modified-date">This page was last modified on<!-- --> <time dateTime="2024-07-29T19:46:22.000Z">29 de jul. de 2024</time> by<!-- --> <a href="/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction/contributors.txt" rel="nofollow">MDN contributors</a>.</p><div id="on-github" class="on-github"><a href="https://github.com/mdn/translated-content/blob/main/files/pt-br/learn/javascript/client-side_web_apis/introduction/index.md?plain=1" title="Folder: pt-br/learn/javascript/client-side_web_apis/introduction (Opens in a new tab)" target="_blank" rel="noopener noreferrer">View this page on GitHub</a> <!-- -->•<!-- --> <a href="https://github.com/mdn/translated-content/issues/new?template=page-report-pt-br.yml&mdn-url=https%3A%2F%2Fdeveloper.mozilla.org%2Fpt-BR%2Fdocs%2FLearn%2FJavaScript%2FClient-side_web_APIs%2FIntroduction&metadata=%3C%21--+Do+not+make+changes+below+this+line+--%3E%0A%3Cdetails%3E%0A%3Csummary%3EPage+report+details%3C%2Fsummary%3E%0A%0A*+Folder%3A+%60pt-br%2Flearn%2Fjavascript%2Fclient-side_web_apis%2Fintroduction%60%0A*+MDN+URL%3A+https%3A%2F%2Fdeveloper.mozilla.org%2Fpt-BR%2Fdocs%2FLearn%2FJavaScript%2FClient-side_web_APIs%2FIntroduction%0A*+GitHub+URL%3A+https%3A%2F%2Fgithub.com%2Fmdn%2Ftranslated-content%2Fblob%2Fmain%2Ffiles%2Fpt-br%2Flearn%2Fjavascript%2Fclient-side_web_apis%2Fintroduction%2Findex.md%0A*+Last+commit%3A+https%3A%2F%2Fgithub.com%2Fmdn%2Ftranslated-content%2Fcommit%2Fb75339ae65c5d298dfc1f2e3c48547c2839b00d8%0A*+Document+last+modified%3A+2024-07-29T19%3A46%3A22.000Z%0A%0A%3C%2Fdetails%3E" title="This will take you to GitHub to file a new issue." target="_blank" rel="noopener noreferrer">Report a problem with this content</a></div></div></aside></main></div></div><footer id="nav-footer" class="page-footer"><div class="page-footer-grid"><div class="page-footer-logo-col"><a href="/" class="mdn-footer-logo" aria-label="MDN homepage"><svg width="48" height="17" viewBox="0 0 48 17" fill="none" xmlns="http://www.w3.org/2000/svg"><title id="mdn-footer-logo-svg">MDN logo</title><path d="M20.04 16.512H15.504V10.416C15.504 9.488 15.344 8.824 15.024 8.424C14.72 8.024 14.264 7.824 13.656 7.824C12.92 7.824 12.384 8.064 12.048 8.544C11.728 9.024 11.568 9.64 11.568 10.392V14.184H13.008V16.512H8.472V10.416C8.472 9.488 8.312 8.824 7.992 8.424C7.688 8.024 7.232 7.824 6.624 7.824C5.872 7.824 5.336 8.064 5.016 8.544C4.696 9.024 4.536 9.64 4.536 10.392V14.184H6.6V16.512H0V14.184H1.44V8.04H0.024V5.688H4.536V7.32C5.224 6.088 6.32 5.472 7.824 5.472C8.608 5.472 9.328 5.664 9.984 6.048C10.64 6.432 11.096 7.016 11.352 7.8C11.992 6.248 13.168 5.472 14.88 5.472C15.856 5.472 16.72 5.776 17.472 6.384C18.224 6.992 18.6 7.936 18.6 9.216V14.184H20.04V16.512Z" fill="currentColor"></path><path d="M33.6714 16.512H29.1354V14.496C28.8314 15.12 28.3834 15.656 27.7914 16.104C27.1994 16.536 26.4154 16.752 25.4394 16.752C24.0154 16.752 22.8954 16.264 22.0794 15.288C21.2634 14.312 20.8554 12.984 20.8554 11.304C20.8554 9.688 21.2554 8.312 22.0554 7.176C22.8554 6.04 24.0634 5.472 25.6794 5.472C26.5594 5.472 27.2794 5.648 27.8394 6C28.3994 6.352 28.8314 6.8 29.1354 7.344V2.352H26.9754V0H32.2314V14.184H33.6714V16.512ZM29.1354 11.04V10.776C29.1354 9.88 28.8954 9.184 28.4154 8.688C27.9514 8.176 27.3674 7.92 26.6634 7.92C25.9754 7.92 25.3674 8.176 24.8394 8.688C24.3274 9.2 24.0714 10.008 24.0714 11.112C24.0714 12.152 24.3114 12.944 24.7914 13.488C25.2714 14.032 25.8394 14.304 26.4954 14.304C27.3114 14.304 27.9514 13.96 28.4154 13.272C28.8954 12.584 29.1354 11.84 29.1354 11.04Z" fill="currentColor"></path><path d="M47.9589 16.512H41.9829V14.184H43.4229V10.416C43.4229 9.488 43.2629 8.824 42.9429 8.424C42.6389 8.024 42.1829 7.824 41.5749 7.824C40.8389 7.824 40.2709 8.056 39.8709 8.52C39.4709 8.968 39.2629 9.56 39.2469 10.296V14.184H40.6869V16.512H34.7109V14.184H36.1509V8.04H34.5909V5.688H39.2469V7.344C39.9669 6.096 41.1269 5.472 42.7269 5.472C43.7509 5.472 44.6389 5.776 45.3909 6.384C46.1429 6.992 46.5189 7.936 46.5189 9.216V14.184H47.9589V16.512Z" fill="currentColor"></path></svg></a><p>Your blueprint for a better internet.</p><ul class="social-icons"><li><a href="https://mozilla.social/@mdn" target="_blank" rel="me noopener noreferrer"><span class="icon icon-mastodon"></span><span class="visually-hidden">MDN on Mastodon</span></a></li><li><a href="https://twitter.com/mozdevnet" target="_blank" rel="noopener noreferrer"><span class="icon icon-twitter-x"></span><span class="visually-hidden">MDN on X (formerly Twitter)</span></a></li><li><a href="https://github.com/mdn/" target="_blank" rel="noopener noreferrer"><span class="icon icon-github-mark-small"></span><span class="visually-hidden">MDN on GitHub</span></a></li><li><a href="/en-US/blog/rss.xml" target="_blank"><span class="icon icon-feed"></span><span class="visually-hidden">MDN Blog RSS Feed</span></a></li></ul></div><div class="page-footer-nav-col-1"><h2 class="footer-nav-heading">MDN</h2><ul class="footer-nav-list"><li class="footer-nav-item"><a href="/en-US/about">About</a></li><li class="footer-nav-item"><a href="/en-US/blog/">Blog</a></li><li class="footer-nav-item"><a href="https://www.mozilla.org/en-US/careers/listings/?team=ProdOps" target="_blank" rel="noopener noreferrer">Careers</a></li><li class="footer-nav-item"><a href="/en-US/advertising">Advertise with us</a></li></ul></div><div class="page-footer-nav-col-2"><h2 class="footer-nav-heading">Support</h2><ul class="footer-nav-list"><li class="footer-nav-item"><a class="footer-nav-link" href="https://support.mozilla.org/products/mdn-plus">Product help</a></li><li class="footer-nav-item"><a class="footer-nav-link" href="/pt-BR/docs/MDN/Community/Issues">Report an issue</a></li></ul></div><div class="page-footer-nav-col-3"><h2 class="footer-nav-heading">Our communities</h2><ul class="footer-nav-list"><li class="footer-nav-item"><a class="footer-nav-link" href="/en-US/community">MDN Community</a></li><li class="footer-nav-item"><a class="footer-nav-link" href="https://discourse.mozilla.org/c/mdn/236" target="_blank" rel="noopener noreferrer">MDN Forum</a></li><li class="footer-nav-item"><a class="footer-nav-link" href="/discord" target="_blank" rel="noopener noreferrer">MDN Chat</a></li></ul></div><div class="page-footer-nav-col-4"><h2 class="footer-nav-heading">Developers</h2><ul class="footer-nav-list"><li class="footer-nav-item"><a class="footer-nav-link" href="/pt-BR/docs/Web">Web Technologies</a></li><li class="footer-nav-item"><a class="footer-nav-link" href="/pt-BR/docs/Learn">Learn Web Development</a></li><li class="footer-nav-item"><a class="footer-nav-link" href="/pt-BR/plus">MDN Plus</a></li><li class="footer-nav-item"><a href="https://hacks.mozilla.org/" target="_blank" rel="noopener noreferrer">Hacks Blog</a></li></ul></div><div class="page-footer-moz"><a href="https://www.mozilla.org/" class="footer-moz-logo-link" target="_blank" rel="noopener noreferrer"><svg width="112" height="32" fill="none" xmlns="http://www.w3.org/2000/svg"><title id="mozilla-footer-logo-svg">Mozilla logo</title><path d="M41.753 14.218c-2.048 0-3.324 1.522-3.324 4.157 0 2.423 1.119 4.286 3.29 4.286 2.082 0 3.447-1.678 3.447-4.347 0-2.826-1.522-4.096-3.413-4.096Zm54.89 7.044c0 .901.437 1.618 1.645 1.618 1.427 0 2.949-1.024 3.044-3.352-.649-.095-1.365-.185-2.02-.185-1.426-.005-2.668.397-2.668 1.92Z" fill="currentColor"></path><path d="M0 0v32h111.908V0H0Zm32.56 25.426h-5.87v-7.884c0-2.423-.806-3.352-2.39-3.352-1.924 0-2.702 1.365-2.702 3.324v4.868h1.864v3.044h-5.864v-7.884c0-2.423-.806-3.352-2.39-3.352-1.924 0-2.702 1.365-2.702 3.324v4.868h2.669v3.044H6.642v-3.044h1.863v-7.918H6.642V11.42h5.864v2.11c.839-1.489 2.3-2.39 4.252-2.39 2.02 0 3.878.963 4.566 3.01.778-1.862 2.361-3.01 4.566-3.01 2.512 0 4.812 1.522 4.812 4.84v6.402h1.863v3.044h-.005Zm9.036.307c-4.314 0-7.296-2.635-7.296-7.106 0-4.096 2.484-7.481 7.514-7.481s7.481 3.38 7.481 7.29c0 4.472-3.228 7.297-7.699 7.297Zm22.578-.307H51.942l-.403-2.11 7.7-8.846h-4.376l-.621 2.17-2.888-.313.498-4.907h12.294l.313 2.11-7.767 8.852h4.533l.654-2.172 3.167.308-.872 4.908Zm7.99 0h-4.191v-5.03h4.19v5.03Zm0-8.976h-4.191v-5.03h4.19v5.03Zm2.618 8.976 6.054-21.358h3.945l-6.054 21.358h-3.945Zm8.136 0 6.048-21.358h3.945l-6.054 21.358h-3.939Zm21.486.307c-1.863 0-2.887-1.085-3.072-2.792-.805 1.427-2.232 2.792-4.498 2.792-2.02 0-4.314-1.085-4.314-4.006 0-3.447 3.323-4.253 6.518-4.253.778 0 1.584.034 2.3.124v-.465c0-1.427-.034-3.133-2.3-3.133-.84 0-1.488.061-2.143.402l-.453 1.578-3.195-.34.549-3.224c2.45-.996 3.692-1.27 5.992-1.27 3.01 0 5.556 1.55 5.556 4.75v6.083c0 .805.314 1.085.963 1.085.184 0 .375-.034.587-.095l.034 2.11a5.432 5.432 0 0 1-2.524.654Z" fill="currentColor"></path></svg></a><ul class="footer-moz-list"><li class="footer-moz-item"><a href="https://www.mozilla.org/privacy/websites/" class="footer-moz-link" target="_blank" rel="noopener noreferrer">Website Privacy Notice</a></li><li class="footer-moz-item"><a href="https://www.mozilla.org/privacy/websites/#cookies" class="footer-moz-link" target="_blank" rel="noopener noreferrer">Cookies</a></li><li class="footer-moz-item"><a href="https://www.mozilla.org/about/legal/terms/mozilla" class="footer-moz-link" target="_blank" rel="noopener noreferrer">Legal</a></li><li class="footer-moz-item"><a href="https://www.mozilla.org/about/governance/policies/participation/" class="footer-moz-link" target="_blank" rel="noopener noreferrer">Community Participation Guidelines</a></li></ul></div><div class="page-footer-legal"><p id="license" class="page-footer-legal-text">Visit<!-- --> <a href="https://www.mozilla.org" target="_blank" rel="noopener noreferrer">Mozilla Corporation’s</a> <!-- -->not-for-profit parent, the<!-- --> <a target="_blank" rel="noopener noreferrer" href="https://foundation.mozilla.org/">Mozilla Foundation</a>.<br/>Portions of this content are ©1998–<!-- -->2024<!-- --> by individual mozilla.org contributors. Content available under<!-- --> <a href="/pt-BR/docs/MDN/Writing_guidelines/Attrib_copyright_license">a Creative Commons license</a>.</p></div></div></footer></div><script type="application/json" id="hydration">{"url":"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction","doc":{"isMarkdown":true,"isTranslated":true,"isActive":true,"flaws":{},"title":"Introdução às Web APIs","mdn_url":"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction","locale":"pt-BR","native":"Português (do Brasil)","sidebarHTML":"<ol><li class=\"section\"><a href=\"/pt-BR/docs/Learn/Getting_started_with_the_web\">Completos iniciantes, comecem por aqui!</a></li><li><details><summary>Iniciando na Internet</summary><ol><li><a href=\"/pt-BR/docs/Learn/Getting_started_with_the_web\">Introdução à Web</a></li><li><a href=\"/pt-BR/docs/Learn/Getting_started_with_the_web/Installing_basic_software\">Instalando os programas básicos</a></li><li><a href=\"/pt-BR/docs/Learn/Getting_started_with_the_web/What_will_your_website_look_like\">Como será o seu site?</a></li><li><a href=\"/pt-BR/docs/Learn/Getting_started_with_the_web/Dealing_with_files\">Lidando com arquivos</a></li><li><a href=\"/pt-BR/docs/Learn/Getting_started_with_the_web/HTML_basics\">HTML básico</a></li><li><a href=\"/pt-BR/docs/Learn/Getting_started_with_the_web/CSS_basics\">CSS básico</a></li><li><a href=\"/pt-BR/docs/Learn/Getting_started_with_the_web/JavaScript_basics\">Noções básicas de JavaScript</a></li><li><a href=\"/pt-BR/docs/Learn/Getting_started_with_the_web/Publishing_your_website\">Publicando seu site</a></li><li><a href=\"/pt-BR/docs/Learn/Getting_started_with_the_web/How_the_Web_works\">Como a Web funciona</a></li></ol></details></li><li class=\"section\"><a href=\"/pt-BR/docs/Learn/HTML\">HTML — Estruturando a Web</a></li><li><details><summary>Introdução ao HTML</summary><ol><li><a href=\"/pt-BR/docs/Learn/HTML/Introduction_to_HTML\">Introdução ao HTML</a></li><li><a href=\"/pt-BR/docs/Learn/HTML/Introduction_to_HTML/Getting_started\">Iniciando com HTML</a></li><li><a href=\"/pt-BR/docs/Learn/HTML/Introduction_to_HTML/The_head_metadata_in_HTML\">O que está no cabeçalho? Metadados em HTML</a></li><li><a href=\"/pt-BR/docs/Learn/HTML/Introduction_to_HTML/HTML_text_fundamentals\">Fundamentos do texto em HTML</a></li><li><a href=\"/pt-BR/docs/Learn/HTML/Introduction_to_HTML/Creating_hyperlinks\">Criando hyperlinks</a></li><li><a href=\"/pt-BR/docs/Learn/HTML/Introduction_to_HTML/Advanced_text_formatting\">Formatação avançada de texto</a></li><li><a href=\"/pt-BR/docs/Learn/HTML/Introduction_to_HTML/Document_and_website_structure\">Estrutura de documento e sites</a></li><li><a href=\"/pt-BR/docs/Learn/HTML/Introduction_to_HTML/Debugging_HTML\">Debugging HTML</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/HTML/Introduction_to_HTML/Marking_up_a_letter\">Marking up a letter</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/HTML/Introduction_to_HTML/Structuring_a_page_of_content\">Structuring a page of content</a></li></ol></details></li><li><details><summary>Multimídia e incorporação</summary><ol><li><a href=\"/pt-BR/docs/Learn/HTML/Multimedia_and_embedding\">Multimídia e Incorporação</a></li><li><a href=\"/pt-BR/docs/Learn/HTML/Multimedia_and_embedding/Images_in_HTML\">Imagens no HTML</a></li><li><a href=\"/pt-BR/docs/Learn/HTML/Multimedia_and_embedding/Video_and_audio_content\">Conteúdo de vídeo e áudio</a></li><li><a href=\"/pt-BR/docs/Learn/HTML/Multimedia_and_embedding/Other_embedding_technologies\">Do objeto ao iframe - outras tecnologias de incorporação</a></li><li><a href=\"/pt-BR/docs/Learn/HTML/Multimedia_and_embedding/Adding_vector_graphics_to_the_Web\">Adicionando vetor gráfico na web</a></li><li><a href=\"/pt-BR/docs/Learn/HTML/Multimedia_and_embedding/Responsive_images\">Imagens responsivas</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/HTML/Multimedia_and_embedding/Mozilla_splash_page\">Mozilla splash page</a></li></ol></details></li><li><details><summary>Tabelas HTML</summary><ol><li><a href=\"/pt-BR/docs/Learn/HTML/Tables\">Tabelas em HTML</a></li><li><a href=\"/pt-BR/docs/Learn/HTML/Tables/Basics\">HTML table basics</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/HTML/Tables/Advanced\">HTML table advanced features and accessibility</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/HTML/Tables/Structuring_planet_data\">Structuring planet data</a></li></ol></details></li><li class=\"section\"><a href=\"/pt-BR/docs/Learn/CSS\">CSS — Estilizando a Web</a></li><li><details><summary>CSS - primeiros passos</summary><ol><li><a href=\"/pt-BR/docs/Learn/CSS/First_steps\">Primeiros passos com CSS</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/First_steps/What_is_CSS\">O que é CSS?</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/First_steps/Getting_started\">Iniciando com CSS</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/First_steps/How_CSS_is_structured\">Como CSS é estruturado</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/First_steps/How_CSS_works\">Como funciona o CSS</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/First_steps/Styling_a_biography_page\">Usando seu novo conhecimento</a></li></ol></details></li><li><details><summary>CSS building blocks</summary><ol><li><a href=\"/pt-BR/docs/Learn/CSS/Building_blocks\">Construindo blocos CSS</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/Building_blocks/Selectors\">CSS selectors</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/Building_blocks/Selectors/Type_Class_and_ID_Selectors\">Seletores de tipo, classe e ID</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/Building_blocks/Selectors/Attribute_selectors\">Seletores de atributo</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Selectors/Pseudo-classes_and_pseudo-elements\">Pseudo-classes and pseudo-elements</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Selectors/Combinators\">Combinators</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/Building_blocks/Cascade_and_inheritance\">Cascata, especificidade e herança</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Cascade_layers\">Cascade layers</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/Building_blocks/The_box_model\">The box model</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Backgrounds_and_borders\">Backgrounds and borders</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Handling_different_text_directions\">Handling different text directions</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Overflowing_content\">Overflowing content</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Values_and_units\">CSS values and units</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Sizing_items_in_CSS\">Sizing items in CSS</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Images_media_form_elements\">Images, media, and form elements</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Styling_tables\">Styling tables</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Advanced_styling_effects\">Advanced styling effects</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Debugging_CSS\">Debugging CSS</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Organizing\">Organizing your CSS</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Fundamental_CSS_comprehension\">Fundamental CSS comprehension</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/Creating_fancy_letterheaded_paper\">Creating fancy letterheaded paper</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Building_blocks/A_cool_looking_box\">A cool-looking box</a></li></ol></details></li><li><details><summary>Estilização de textos</summary><ol><li><a href=\"/pt-BR/docs/Learn/CSS/Styling_text\">Estilizando texto</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Styling_text/Fundamentals\">Fundamental text and font styling</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/Styling_text/Styling_lists\">Manipulando Listas</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Styling_text/Styling_links\">Styling links</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Styling_text/Web_fonts\">Web fonts</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Styling_text/Typesetting_a_homepage\">Typesetting a community school homepage</a></li></ol></details></li><li><details><summary>Esquemas CSS</summary><ol><li><a href=\"/pt-BR/docs/Learn/CSS/CSS_layout\">CSS layout</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/CSS_layout/Introduction\">Introdução ao leiaute com CSS</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/CSS_layout/Normal_Flow\">Fluxo Normal</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/CSS_layout/Flexbox\">Flexbox</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/CSS_layout/Grids\">Grids</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/CSS_layout/Floats\">Floats</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/CSS_layout/Positioning\">Positioning</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/CSS_layout/Multiple-column_Layout\">Layout de varias colunas</a></li><li><a href=\"/pt-BR/docs/Learn/CSS/CSS_layout/Responsive_Design\">Design Responsivo</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/CSS_layout/Media_queries\">Beginner's guide to media queries</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/CSS_layout/Legacy_Layout_Methods\">Legacy layout methods</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/CSS_layout/Supporting_Older_Browsers\">Supporting older browsers</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/CSS_layout/Fundamental_Layout_Comprehension\">Fundamental layout comprehension</a></li></ol></details></li><li class=\"section\"><a href=\"/pt-BR/docs/Learn/JavaScript\">JavaScript — Uma linguagem de script dinâmica para aplicações cliente</a></li><li><details><summary>Primeiros passos com JavaScript</summary><ol><li><a href=\"/pt-BR/docs/Learn/JavaScript/First_steps\">Primeiros passos com JavaScript</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/First_steps/What_is_JavaScript\">O que é JavaScript?</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/First_steps/A_first_splash\">Um primeiro mergulho no JavaScript</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/First_steps/What_went_wrong\">O que deu errado? Resolvendo problemas no JavaScript</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/First_steps/Variables\">Armazenando as informações que você precisa — Variáveis</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/First_steps/Math\">Matemática básica no JavaScript — números e operadores</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/First_steps/Strings\">Trabalhando com texto — strings em JavaScript</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/First_steps/Useful_string_methods\">Métodos úteis de string</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/First_steps/Arrays\">Arrays</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/First_steps/Silly_story_generator\">Gerador de histórias bobas</a></li></ol></details></li><li><details><summary>Programando em JavaScript</summary><ol><li><a href=\"/pt-BR/docs/Learn/JavaScript/Building_blocks\">Elementos construtivos do Javascript</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Building_blocks/conditionals\">Tomando decisões no seu código — condicionais</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Building_blocks/Looping_code\">Código em loop</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Building_blocks/Functions\">Funções — blocos reutilizáveis de código</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Building_blocks/Build_your_own_function\">Construa sua própria função</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Building_blocks/Return_values\">Valores de retorno de função</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Building_blocks/Events\">Introdução a eventos</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Building_blocks/Event_bubbling\">Comparativo entre Event Targets</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Building_blocks/Image_gallery\">Galeria de Imagens</a></li></ol></details></li><li><details><summary>Introdução Objetos em JavaScript</summary><ol><li><a href=\"/pt-BR/docs/Learn/JavaScript/Objects\">Introdução a objetos em Javascript</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Objects/Basics\">O básico sobre objetos JavaScript</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Objects/Object_prototypes\">Protótipos de objetos</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/JavaScript/Objects/Object-oriented_programming\">Object-oriented programming</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Objects/Classes_in_JavaScript\">Herança em JavaScript</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Objects/JSON\">Trabalhando com JSON</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Objects/Object_building_practice\">Prática de construção de objetos</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Objects/Adding_bouncing_balls_features\">Adicionando recursos à nossa demonstração de bolas pulantes</a></li></ol></details></li><li><details><summary>Asynchronous JavaScript</summary><ol><li><a href=\"/pt-BR/docs/Learn/JavaScript/Asynchronous\">JavaScript Assíncrono</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Asynchronous/Introducing\">Introdução ao JavaScript Async</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Asynchronous/Promises\">Como usar Promises</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/JavaScript/Asynchronous/Implementing_a_promise-based_API\">How to implement a promise-based API</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/JavaScript/Asynchronous/Introducing_workers\">Introducing workers</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/JavaScript/Asynchronous/Sequencing_animations\">Sequencing animations</a></li></ol></details></li><li><details open=\"\"><summary>APIs Web na aplicação Cliente</summary><ol><li><a href=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs\">APIs web do lado cliente</a></li><li><em><a href=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction\" aria-current=\"page\">Introdução às Web APIs</a></em></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Manipulating_documents\">JavaScript e CSS</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Fetching_data\">AJAX</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/JavaScript/Client-side_web_APIs/Third_party_APIs\">Third-party APIs</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/JavaScript/Client-side_web_APIs/Drawing_graphics\">Drawing graphics</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/JavaScript/Client-side_web_APIs/Video_and_audio_APIs\">Video and Audio APIs</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Client-side_storage\">Client-side storage</a></li></ol></details></li><li class=\"section\"><a href=\"/pt-BR/docs/Learn/Forms\">Web forms — Working with user data</a></li><li><details><summary>Web form building blocks</summary><ol><li><a href=\"/pt-BR/docs/Learn/Forms\">Formulários da Web - Trabalhando com dados do usuário</a></li><li><a href=\"/pt-BR/docs/Learn/Forms/Your_first_form\">Meu primeiro formulário HTML</a></li><li><a href=\"/pt-BR/docs/Learn/Forms/How_to_structure_a_web_form\">Como estruturar um formulário HTML</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Forms/Basic_native_form_controls\">Basic native form controls</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Forms/HTML5_input_types\">The HTML5 input types</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Forms/Other_form_controls\">Other form controls</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Forms/Styling_web_forms\">Styling web forms</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Forms/Advanced_form_styling\">Advanced form styling</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Forms/UI_pseudo-classes\">UI pseudo-classes</a></li><li><a href=\"/pt-BR/docs/Learn/Forms/Form_validation\">Form data validation</a></li><li><a href=\"/pt-BR/docs/Learn/Forms/Sending_and_retrieving_form_data\">Sending form data</a></li></ol></details></li><li><details><summary>Advanced web form techniques</summary><ol><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Forms/How_to_build_custom_form_controls\">How to build custom form controls</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Forms/Sending_forms_through_JavaScript\">Sending forms through JavaScript</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Forms/Property_compatibility_table_for_form_controls\">CSS property compatibility table for form controls</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Forms/HTML_forms_in_legacy_browsers\">HTML forms in legacy browsers</a></li></ol></details></li><li class=\"section\"><a href=\"/pt-BR/docs/Learn/Accessibility\">Acessibilidade — Faça a Internet usável por qualquer pessoa</a></li><li><details><summary>Guias de acessibilidade</summary><ol><li><a href=\"/pt-BR/docs/Learn/Accessibility\">Accessibility</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Accessibility/What_is_accessibility\">What is accessibility?</a></li><li><a href=\"/pt-BR/docs/Learn/Accessibility/HTML\">HTML: Boas práticas em acessibilidade</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Accessibility/CSS_and_JavaScript\">CSS and JavaScript accessibility best practices</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Accessibility/WAI-ARIA_basics\">WAI-ARIA basics</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Accessibility/Multimedia\">Accessible multimedia</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Accessibility/Mobile\">Mobile accessibility</a></li><li><a href=\"/pt-BR/docs/Learn/Accessibility/Accessibility_troubleshooting\">Avaliação: solucionando problemas de acessibilidade</a></li></ol></details></li><li class=\"section\"><a href=\"/pt-BR/docs/Learn/Performance\">Performance — Making websites fast and responsive</a></li><li><details><summary>Performance guides</summary><ol><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Performance\">Web performance</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Performance/why_web_performance\">The \"why\" of web performance</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Performance/What_is_web_performance\">What is web performance?</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Performance/Perceived_performance\">Perceived performance</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Performance/Measuring_performance\">Measuring performance</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Performance/Multimedia\">Multimedia: Images</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Performance/video\">Multimedia: video</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Performance/JavaScript\">JavaScript performance optimization</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Performance/HTML\">HTML performance optimization</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Performance/CSS\">CSS performance optimization</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Performance/business_case_for_performance\">The business case for web performance</a></li></ol></details></li><li class=\"section\"><a href=\"/pt-BR/docs/Learn/MathML\">MathML — Writing mathematics with MathML</a></li><li><details><summary>MathML first steps</summary><ol><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/MathML/First_steps\">MathML first steps</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/MathML/First_steps/Getting_started\">Getting started with MathML</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/MathML/First_steps/Text_containers\">MathML Text Containers</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/MathML/First_steps/Fractions_and_roots\">MathML fractions and roots</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/MathML/First_steps/Scripts\">MathML scripted elements</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/MathML/First_steps/Tables\">MathML tables</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/MathML/First_steps/Three_famous_mathematical_formulas\">Three famous mathematical formulas</a></li></ol></details></li><li class=\"section\"><a href=\"/pt-BR/docs/Learn/../Games\">Games — Developing games for the web</a></li><li><details><summary>Guides and tutorials</summary><ol><li><a href=\"/pt-BR/docs/Games/Introduction\">Introdução ao desenvolvimento de jogos para a Web</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Games/Techniques\">Techniques for game development</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Games/Tutorials\">Tutorials</a></li><li><a href=\"/pt-BR/docs/Games/Publishing_games\">Publishing games</a></li></ol></details></li><li class=\"section\"><a href=\"/pt-BR/docs/Learn/Tools_and_testing\">Ferramentas e teste</a></li><li><details><summary>Client-side web development tools</summary><ol><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools\">Understanding client-side web development tools</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Overview\">Client-side tooling overview</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Command_line\">Command line crash course</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Package_management\">Package management basics</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Introducing_complete_toolchain\">Introducing a complete toolchain</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Deployment\">Deploying our app</a></li></ol></details></li><li><details><summary>Introduction to client-side frameworks</summary><ol><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Introduction\">Introduction to client-side frameworks</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Main_features\">Framework main features</a></li></ol></details></li><li><details><summary>React</summary><ol><li><a href=\"/pt-BR/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/React_getting_started\">Começando com React</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/React_todo_list_beginning\">Beginning our React todo list</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/React_components\">Componentizing our React app</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/React_interactivity_events_state\">React interactivity: Events and state</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/React_interactivity_filtering_conditional_rendering\">React interactivity: Editing, filtering, conditional rendering</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/React_accessibility\">Accessibility in React</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/React_resources\">React resources</a></li></ol></details></li><li><details><summary>Ember</summary><ol><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Ember_getting_started\">Getting started with Ember</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Ember_structure_componentization\">Ember app structure and componentization</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Ember_interactivity_events_state\">Ember interactivity: Events, classes and state</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Ember_conditional_footer\">Ember Interactivity: Footer functionality, conditional rendering</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Ember_routing\">Routing in Ember</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Ember_resources\">Ember resources and troubleshooting</a></li></ol></details></li><li><details><summary>Vue</summary><ol><li><a href=\"/pt-BR/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_getting_started\">Iniciando com Vue</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_first_component\">Creating our first Vue component</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_rendering_lists\">Rendering a list of Vue components</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_methods_events_models\">Adding a new todo form: Vue events, methods, and models</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_styling\">Styling Vue components with CSS</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_computed_properties\">Using Vue computed properties</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_conditional_rendering\">Vue conditional rendering: editing existing todos</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_refs_focus_management\">Vue refs and lifecycle methods for focus management</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Vue_resources\">Vue resources</a></li></ol></details></li><li><details><summary>Svelte</summary><ol><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_getting_started\">Getting started with Svelte</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_Todo_list_beginning\">Starting our Svelte to-do list app</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_variables_props\">Dynamic behavior in Svelte: working with variables and props</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_components\">Componentizing our Svelte app</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_reactivity_lifecycle_accessibility\">Advanced Svelte: Reactivity, lifecycle, accessibility</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_stores\">Working with Svelte stores</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_TypeScript\">TypeScript support in Svelte</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Svelte_deployment_next\">Deployment and next steps</a></li></ol></details></li><li><details><summary>Angular</summary><ol><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Angular_getting_started\">Getting started with Angular</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Angular_todo_list_beginning\">Beginning our Angular todo list app</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Angular_styling\">Styling our Angular app</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Angular_item_component\">Creating an item component</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Angular_filtering\">Filtering our to-do items</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Client-side_JavaScript_frameworks/Angular_building\">Building Angular applications and further resources</a></li></ol></details></li><li><details><summary>Git and GitHub</summary><ol><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/GitHub\">Git and GitHub</a></li></ol></details></li><li><details><summary>Testes entre navegadores</summary><ol><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing\">Cross browser testing</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/Introduction\">Introduction to cross-browser testing</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/Testing_strategies\">Strategies for carrying out testing</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/HTML_and_CSS\">Handling common HTML and CSS problems</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/JavaScript\">Handling common JavaScript problems</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/Accessibility\">Handling common accessibility problems</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/Feature_detection\">Implementing feature detection</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/Automated_testing\">Introduction to automated testing</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing/Your_own_automation_environment\">Setting up your own test automation environment</a></li></ol></details></li><li class=\"section\"><a href=\"/pt-BR/docs/Learn/Server-side\">Programação de servidores de Aplicação</a></li><li><details><summary>Primeiros passos</summary><ol><li><a href=\"/pt-BR/docs/Learn/Server-side/First_steps\">Primeiros passos programando o site no servidor</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/First_steps/Introduction\">Introdução ao lado servidor</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/First_steps/Client-Server_overview\">Visão geral do cliente-servidor</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Server-side/First_steps/Web_frameworks\">Server-side web frameworks</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/First_steps/Website_security\">Segurança em aplicação web</a></li></ol></details></li><li><details><summary>Framework Web Django (Python)</summary><ol><li><a href=\"/pt-BR/docs/Learn/Server-side/Django\">Django Web Framework (Python)</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Django/Introduction\">Introdução ao Django</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Django/development_environment\">Configurando um ambiente de desenvolvimento Django</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Django/Tutorial_local_library_website\">Tutorial Django: Website da Biblioteca Local</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Django/skeleton_website\">Django Tutorial Parte 2: Criando o \"esqueleto\" de um site</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Django/Models\">Tutorial Django Parte 3: Usando models</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Django/Admin_site\">Tutorial Django Parte 4: Django admin site</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Django/Home_page\">Django Tutorial Parte 5: Criando nossa home page</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Django/Generic_views\">Tutorial Django Parte 6: Lista genérica e detail views</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Django/Sessions\">Tutorial Django Parte 7: Sessões</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Django/Authentication\">Tutorial Django Parte 8: Autenticação de usuário e permissões</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Django/Forms\">Tutorial Django Parte 9: Trabalhando com formulários</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Django/Testing\">Tutorial Django Parte 10: Testando uma aplicação web Django</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Django/Deployment\">Tutorial Django Parte 11: Hospedando Django para produção</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Django/web_application_security\">Segurança de aplicações web Django</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Server-side/Django/django_assessment_blog\">Assessment: DIY Django mini blog</a></li></ol></details></li><li><details><summary>Framework Web Express (Node.js/JavaScript)</summary><ol><li><a href=\"/pt-BR/docs/Learn/Server-side/Express_Nodejs\">Express Web Framework (Node.js/JavaScript)</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Express_Nodejs/Introduction\">Introdução Express/Node</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Express_Nodejs/development_environment\">Configurando o Node como ambiente de desenvolvimento</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Express_Nodejs/Tutorial_local_library_website\">Express: Tutorial para criar o site de uma Biblioteca Local</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Express_Nodejs/skeleton_website\">Express Tutorial Parte 2: Criando a estrutura do website</a></li><li><a href=\"/pt-BR/docs/Learn/Server-side/Express_Nodejs/mongoose\">Tutorial Express Parte 3: Usando um banco de dados (com Mongoose)</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Server-side/Express_Nodejs/routes\">Express Tutorial Part 4: Routes and controllers</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Server-side/Express_Nodejs/Displaying_data\">Express Tutorial Part 5: Displaying library data</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Server-side/Express_Nodejs/forms\">Express Tutorial Part 6: Working with forms</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Server-side/Express_Nodejs/deployment\">Express Tutorial Part 7: Deploying to production</a></li></ol></details></li><li class=\"section\"><a href=\"/pt-BR/docs/Learn/Common_questions\">Mais recursos</a></li><li><details><summary>Questões gerais</summary><ol><li><a href=\"/pt-BR/docs/Learn/Common_questions\">Questões comuns</a></li><li><a href=\"/pt-BR/docs/Learn/HTML/Howto\">Use HTML para resolver problemas comuns</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/CSS/Howto\">Use CSS to solve common problems</a></li><li><a href=\"/pt-BR/docs/Learn/JavaScript/Howto\">Solve common problems in your JavaScript code</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Common_questions/Web_mechanics\">Web mechanics</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Common_questions/Tools_and_setup\">Tools and setup</a></li><li><a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Learn/Common_questions/Design_and_accessibility\">Design and accessibility</a></li></ol></details></li></ol>","sidebarMacro":"LearnSidebar","body":[{"type":"prose","value":{"id":null,"title":null,"isH3":false,"content":"<ul class=\"prev-next\">\n \n <li><a class=\"button secondary\" href=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs\"><span class=\"button-wrap\"> Menu: APIs web do lado cliente</span></a></li>\n <li><a class=\"button secondary\" href=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Manipulating_documents\"><span class=\"button-wrap\"> Próxima </span></a></li>\n</ul>\n<p>Primeiro, vamos ver as APIs a partir de um nível mais alto: o que são, como funcionam, como usá-las em seu código e como são estruturadas? Ainda, vamos entender quais são as principais classes de APIs e quais usos elas possuem.</p>\n<figure class=\"table-container\"><table class=\"learn-box standard-table\">\n <tbody>\n <tr>\n <th scope=\"row\">Pré-requisitos:</th>\n <td>\n <p>\n Conhecimentos básicos de computação,\n <a href=\"/pt-BR/docs/Learn/HTML\">HTML</a>,\n <a href=\"/pt-BR/docs/Learn/CSS\">CSS</a> e JavaScript (veja\n <a href=\"/pt-BR/docs/Learn/JavaScript/First_steps\">primeiros passos</a>,\n <a href=\"/pt-BR/docs/Learn/JavaScript/Building_blocks\">elementos construtivos</a>\n e\n <a href=\"/pt-BR/docs/Learn/JavaScript/Objects\">introdução a objetos</a>).\n </p>\n </td>\n </tr>\n <tr>\n <th scope=\"row\">Objetivo:</th>\n <td>\n Familiarizar-se com APIs, o que elas podem fazer, e como usá-las em seu\n código.\n </td>\n </tr>\n </tbody>\n</table></figure>"}},{"type":"prose","value":{"id":"o_que_são_apis","title":"O que são APIs?","isH3":false,"content":"<p>As APIs (Application Programming Interfaces) são construções disponíveis nas linguagens de programação que permitem a desenvolvedores criar funcionalidades complexas mais facilmente. Tais construções abstraem o código mais complexo, proporcionando o uso de sintaxes mais simples em seu lugar.</p>\n<p>Pense no seguinte exemplo: o uso de energia elétrica em sua casa ou apartamento. Quando você deseja utilizar um eletrodoméstico, você precisa somente ligar o aparelho na tomada. Não é preciso conectar diretamente o fio do aparelho diretamente na caixa de luz. Isso seria, além de muito ineficiente, difícil e perigoso de ser feito (caso você não seja eletricista).</p>\n<p>\n <img src=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction/plug-socket.png\" alt=\"\" width=\"700\" height=\"472\" loading=\"lazy\">\n</p>\n<p><em>Fonte da imagem: <a href=\"https://www.flickr.com/photos/easy-pics/9518184890/in/photostream/lightbox/\" class=\"external\" target=\"_blank\">Overloaded plug socket</a> por <a href=\"https://www.flickr.com/photos/easy-pics/\" class=\"external\" target=\"_blank\">The Clear Communication People</a>, retirado do Flickr.</em></p>\n<p>Da mesma forma, caso você queira programar gráficos em 3D, é muito mais fácil usar uma API escrita em linguagem de alto nível como JavaScript ou Python, do que escrever em código de mais baixo nível (C ou C++) que controla diretamente a GPU ou outras funções gráficas.</p>\n<div class=\"notecard note\">\n <p><strong>Nota:</strong> para mais informações, consulte o <a href=\"/pt-BR/docs/Glossary/API\">termo API</a> no glossário.</p>\n</div>"}},{"type":"prose","value":{"id":"apis_javascript_client-side","title":"APIs JavaScript client-side","isH3":true,"content":"<p>A linguagem JavaScript, especialmente client-side, possui diversas APIs disponíveis. Elas não fazem parte da linguagem em si, mas são escritas sobre o <em>core</em> da linguagem JavaScript, fornecendo superpoderes para serem utilizados em seu código. Geralmente, tais APIs fazem parte de uma das seguintes categorias:</p>\n<ul>\n <li><strong>APIs de navegadores:</strong> fazem parte do seu navegador web, sendo capazes de expor dados do navegador e do ambiente ao redor do computador circundante, além de fazer coisas úteis com esses dados. Por exemplo, a <a href=\"/pt-BR/docs/Web/API/Web_Audio_API\">API Web Áudio</a> fornece construções JavaScript simples para manipular áudio em seu navegador - pegar uma faixa de áudio, alterar o volume dela, aplicar efeitos, etc. Por trás dos panos, o navegador utiliza códigos complexos de baixo nível (ex: C++) para realizar o processamento de áudio de fato. Como foi dito anteriormente, essa complexidade toda é abstraída de você pela API.</li>\n <li><strong>APIs de terceiros:</strong> geralmente, não fazem parte do navegador e você precisa recuperar seu código e suas informações de outro local da web. A <a href=\"https://developer.twitter.com/en/docs\" class=\"external\" target=\"_blank\">API do Twitter</a>, por exemplo, permite mostrar os seus últimos tweets no seu site. Ela fornece um conjunto de construções especiais para ser usado de maneira a consultar o serviço do Twitter e retornar informações específicas.</li>\n</ul>\n<p>\n <img src=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction/browser.png\" alt=\"\" width=\"815\" height=\"511\" loading=\"lazy\">\n</p>"}},{"type":"prose","value":{"id":"relacionamento_entre_javascript_apis_e_outras_ferramentas_javascript","title":"Relacionamento entre JavaScript, APIs, e outras ferramentas JavaScript","isH3":true,"content":"<p>Na seção anterior, abordamos as APIs JavaScript client-side e como elas se relacionam com a linguagem JavaScript. Esse ponto merece uma revisão e também uma breve menção de como outras ferramentas JavaScript encaixam-se nesse contexto:</p>\n<ul>\n <li>JavaScript — linguagem de alto nível, embutida em navegadores, que permite implementar funcionalidades em páginas web/aplicativos. A linguagem também está disponível em outros ambientes de programação, tais como o <a href=\"/pt-BR/docs/Learn/Server-side/Express_Nodejs/Introduction\">Node</a>.</li>\n <li>APIs de navegadores — construções presentes no navegador, as quais são baseadas em linguagem JavaScript e permitem a implementação de funcionalidades de uma maneira mais fácil.</li>\n <li>APIs de terceiros — construções presentes em plataformas de terceiros (ex: Twitter, Facebook), que permitem o uso de alguma funcionalidade da plataforma em suas páginas na web. Um exemplo é a possibilidade de mostrar os últimos tweets em sua página.</li>\n <li>Bibliotecas JavaScript — em geral, um ou mais arquivos JavaScript contendo <a href=\"/pt-BR/docs/Learn/JavaScript/Building_blocks/Functions#fun%c3%a7%c3%b5es_personalizadas\">funções personalizadas</a>, as quais podem ser usadas em sua página web para acelerar ou permitir escrever funcionalidades comuns. Exemplos: jQuery, Mootools e React.</li>\n <li>Frameworks JavaScript — uma evolução das bibliotecas. Frameworks JavaScript (ex: Angular e Ember), normalmente, são pacotes de tecnologias HTML, CSS, JavaScript e outras, que você instala e usa para escrever uma aplicação web completa do zero. A principal diferença entre uma biblioteca e um framework é a inversão de controle (\"Inversion of Control\"). Quando um método de uma biblioteca é chamado, a pessoa desenvolvedora está no controle. Em um framework, o controle inverte-se: é o framework que chama o código da pessoa desenvolvedora.</li>\n</ul>"}},{"type":"prose","value":{"id":"o_que_as_apis_podem_fazer","title":"O que as APIs podem fazer?","isH3":false,"content":"<p>Existem muitas APIs disponíveis, nos navegadores modernos, que permitem uma liberdade de ação na hora de codar. Você pode conferir isso na <a href=\"/pt-BR/docs/Web/API\">página de referência das APIs da MDN</a>.</p>"}},{"type":"prose","value":{"id":"apis_comuns_de_navegadores","title":"APIs comuns de navegadores","isH3":true,"content":"<p>As categorias mais comuns de APIs de navegadores que você irá utilizar (e que veremos em detalhes neste módulo), são:</p>\n<ul>\n <li><strong>APIs para manipular documentos</strong> carregados no navegador. O exemplo mais óbvio é a <a href=\"/pt-BR/docs/Web/API/Document_Object_Model\">API DOM (Document Object Model)</a>, que permite manipular HTML e CSS — criando, removendo a alterando o HTML, aplicando dinamicamente novos estilos a sua página, etc. Toda vez que você vê uma janela pop-up em uma página, ou um novo conteúdo é mostrado, o DOM está em ação. Para saber mais sobre estes tipos de API, leia <a href=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Manipulating_documents\">Manipulando documentos</a>.</li>\n <li><strong>APIs</strong> <strong>que buscam dados no servidor</strong> para atualizar pequenas seções da página, por conta própria, são bastante usadas. Isso, a princípio, parece ser um detalhe pequeno, mas tem um impacto enorme na performance e no comportamento dos sites. Se você precisa atualizar a cotação de uma ação ou listar novas histórias disponíveis, a possibilidade de fazer isso instantaneamente sem precisar atualizar a página dá a impressão de um site muito mais responsivo. Entre as APIs que tornam isso possível, podemos destacar o <a href=\"/pt-BR/docs/Web/API/XMLHttpRequest\"><code>XMLHttpRequest</code></a> e a <a href=\"/pt-BR/docs/Web/API/Fetch_API\">API Fetch</a>. Você pode também encontrar o termo <strong>Ajax</strong>, que descreve essa técnica. Para saber mais sobre essas APIs, leia <a href=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Fetching_data\">Fetching data from the server</a>.</li>\n <li><strong>APIs para desenhar e manipular elementos gráficos</strong> são completamente suportados nos browsers — os mais comuns são <a href=\"/pt-BR/docs/Web/API/Canvas_API\">Canvas</a> e <a href=\"/pt-BR/docs/Web/API/WebGL_API\">WebGL</a>, que possibilitam que você atualize os dados dos pixels em um elemento HTML de maneira programática. <a href=\"/pt-BR/docs/Web/HTML/Element/canvas\"><code><canvas></code></a> elemento para criar cenas 2d e 3d. Por exemplo, você poderia dezenhar formas como retangulos e circulos, importar uma imagem para o canvas, e aplicar um filtro para sepia ou grayscale usando o Canvas API, ou criar uma complexa cena 3d com brilho e texturas usando WebGL. Essas APIs são frequentemente combinar com APIs para criar loops de animações(como <a href=\"/pt-BR/docs/Web/API/Window/requestAnimationFrame\"><code>window.requestAnimationFrame()</code></a>) e outros para constantemente lançar cenas like como cartoons e jogos.</li>\n <li><strong><a href=\"/pt-BR/docs/Apps/Fundamentals/Audio_and_video_delivery\">Audio and Video APIs</a></strong> como <a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Web/API/HTMLMediaElement\"><code>HTMLMediaElement</code></a>, a <a href=\"/pt-BR/docs/Web/API/Web_Audio_API\">Web Audio API</a>, e <a href=\"/pt-BR/docs/Web/API/WebRTC_API\">WebRTC</a> permiten a você fazer coisas realmente interessantes com multimedia como a criação personalizada controles de UI para executar audio e video, exibindo faixas de texto como legendas e legendas ocultas junto com seus vídeos, capturando vídeo de sua câmera da web para ser manipulado por meio de uma tela (veja acima) ou exibido no computador de outra pessoa em uma webconferência,ou adicionar efeitos às trilhas de áudio (como ganho, distorção, panorâmica, etc.).</li>\n <li><strong>Device APIs</strong> São basicamente APIs para manipulação e recuperação de dados de hardware de dispositivo moderno de uma forma que seja útil para aplicativos da web.Já falamos sobre a Geolocation API acessando o dispositivo dados de localização para que você possa marcar sua posição em um mapa.Outros exemplos incluem informar ao usuário que uma atualização útil está disponível em um aplicativo da web por meio de notificações do sistema(Veja em <a href=\"/en-US/docs/Web/API/Notifications_API\" class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\">Notifications API</a>)ou hardware de vibração(Veja em <a href=\"/en-US/docs/Web/API/Vibration_API\" class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\">Vibration API</a>).</li>\n <li><strong>Client-side storage APIs</strong> estão se tornando muito mais difundidos em navegadores da web - a capacidade de armazenar dados no lado do cliente é muito útil se você quer criar um app que vai salvar seu estado entre carregamentos de página, e talvez até funcione quando o dispositivo estiver offline. Existem várias opções disponíveis, por exemplo, armazenamento simples de nome / valor com o <a href=\"/pt-BR/docs/Web/API/Web_Storage_API\">Web Storage API</a>, e armazenamento de dados tabulares mais complexos com o <a href=\"/pt-BR/docs/Web/API/IndexedDB_API\">IndexedDB API</a>.</li>\n</ul>"}},{"type":"prose","value":{"id":"apis_comuns_de_terceiros","title":"APIs comuns de terceiros","isH3":true,"content":"<p>APIs de terceiros são bastante variadas. Dentre as mais populares, que você eventualmente irá utilizar em algum momento, podermos destacar:</p>\n<ul>\n <li>A <a href=\"https://dev.twitter.com/overview/documentation\" class=\"external\" target=\"_blank\">Twitter API</a>, que permite coisas como mostrar seu últimos tweets no seu website.</li>\n <li>O <a href=\"https://developers.google.com/maps/\" class=\"external\" target=\"_blank\">Google Maps API</a> permite que você faça todo tipo de coisa com mapas nas suas páginas web (funnily enough, it also powers Google Maps). This is now an entire suite of APIs, which handle a wide variety of tasks, as evidenced by the <a href=\"https://developers.google.com/maps/documentation/api-picker\" class=\"external\" target=\"_blank\">Google Maps API Picker</a>.</li>\n <li>The <a href=\"https://developers.facebook.com/docs/\" class=\"external\" target=\"_blank\">Facebook suite of APIs</a> enables you to use various parts of the Facebook ecosystem to benefit your app, for example by providing app login using Facebook login, accepting in-app payments, rolling out targetted ad campaigns, etc.</li>\n <li>The <a href=\"https://developers.google.com/youtube/\" class=\"external\" target=\"_blank\">YouTube API</a>, which allows you to embed YouTube videos on your site, search YouTube, build playlists, and more.</li>\n <li>The <a href=\"https://www.twilio.com/\" class=\"external\" target=\"_blank\">Twilio API</a>, which provides a framework for building voice and video call functionality into your app, sending SMS/MMS from your apps, and more.</li>\n</ul>\n<div class=\"notecard note\">\n <p><strong>Nota:</strong> Você pode encontrar informações sobre muitas outras APIs de terceiros no <a href=\"http://www.programmableweb.com/category/all/apis\" class=\"external\" target=\"_blank\">Programmable Web API directory</a>.</p>\n</div>"}},{"type":"prose","value":{"id":"como_as_apis_funcionam","title":"Como as APIs funcionam?","isH3":false,"content":"<p>APIs JavaScript possuem pequenas diferenças mas, em geral, possuem funcionalidades em comum e operam de maneira semelhante.</p>"}},{"type":"prose","value":{"id":"elas_são_baseadas_em_objetos","title":"Elas são baseadas em objetos","isH3":true,"content":"<p>Your code interacts with APIs using one or more <a href=\"/pt-BR/docs/Learn/JavaScript/Objects\">JavaScript objects</a>, which serve as containers for the data the API uses (contained in object properties), and the functionality the API makes available (contained in object methods).</p>\n<div class=\"notecard note\">\n <p><strong>Nota:</strong> If you are not already familiar with how objects work, you should go back and work through our <a href=\"/pt-BR/docs/Learn/JavaScript/Objects\">JavaScript objects</a> module before continuing.</p>\n</div>\n<p>Let's return to the example of the Geolocation API — this is a very simple API that consists of a few simple objects:</p>\n<ul>\n <li><a href=\"/pt-BR/docs/Web/API/Geolocation\"><code>Geolocation</code></a>, which contains three methods for controlling the retrieval of geodata.</li>\n <li><a href=\"/pt-BR/docs/Web/API/GeolocationPosition\"><code>Position</code></a>, which represents the position of a device at a given time — this contains a <a href=\"/pt-BR/docs/Web/API/GeolocationCoordinates\"><code>Coordinates</code></a> object that contains the actual position information, plus a timestamp representing the given time.</li>\n <li><a href=\"/pt-BR/docs/Web/API/GeolocationCoordinates\"><code>Coordinates</code></a>, which contains a whole lot of useful data on the device position, including latitude and longitude, altitude, velocity and direction of movement, and more.</li>\n</ul>\n<p>So how do these objects interact? If you look at our <a href=\"https://github.com/mdn/learning-area/blob/master/javascript/apis/introduction/maps-example.html\" class=\"external\" target=\"_blank\">maps-example.html</a> example (<a href=\"https://mdn.github.io/learning-area/javascript/apis/introduction/maps-example.html\" class=\"external\" target=\"_blank\">see it live also</a>), you'll see the following code:</p>\n<div class=\"code-example\"><div class=\"example-header\"><span class=\"language-name\">js</span></div><pre class=\"brush: js notranslate\"><code>navigator.geolocation.getCurrentPosition(function (position) {\n var latlng = new google.maps.LatLng(\n position.coords.latitude,\n position.coords.longitude,\n );\n var myOptions = {\n zoom: 8,\n center: latlng,\n mapTypeId: google.maps.MapTypeId.TERRAIN,\n disableDefaultUI: true,\n };\n var map = new google.maps.Map(\n document.querySelector(\"#map_canvas\"),\n myOptions,\n );\n});\n</code></pre></div>\n<div class=\"notecard note\">\n <p><strong>Nota:</strong> When you first load up the above example, you should be given a dialog box asking if you are happy to share your location with this application (see the <a href=\"#they_have_additional_security_mechanisms_where_appropriate\">They have additional security mechanisms where appropriate</a> section later in the article). You need to agree to this to be able to plot your location on the map. If you still can't see the map, you may need to set your permissions manually; you can do this in various ways depending on what browser you are using; for example in Firefox go to > <em>Tools</em> > <em>Page Info</em> > <em>Permissions</em>, then change the setting for <em>Share Location</em>; in Chrome go to <em>Settings</em> > <em>Privacy</em> > <em>Show advanced settings</em> > <em>Content settings</em> then change the settings for <em>Location</em>.</p>\n</div>\n<p>We first want to use the <a href=\"/pt-BR/docs/Web/API/Geolocation/getCurrentPosition\"><code>Geolocation.getCurrentPosition()</code></a> method to return the current location of our device. The browser's <a href=\"/pt-BR/docs/Web/API/Geolocation\"><code>Geolocation</code></a> object is accessed by calling the <a href=\"/pt-BR/docs/Web/API/Navigator/geolocation\"><code>Navigator.geolocation</code></a> property, so we start off by using</p>\n<div class=\"code-example\"><div class=\"example-header\"><span class=\"language-name\">js</span></div><pre class=\"brush: js notranslate\"><code>navigator.geolocation.getCurrentPosition(function(position) { ... });\n</code></pre></div>\n<p>Isso é equivalente a fazer algo como</p>\n<div class=\"code-example\"><div class=\"example-header\"><span class=\"language-name\">js</span></div><pre class=\"brush: js notranslate\"><code>var myGeo = navigator.geolocation;\nmyGeo.getCurrentPosition(function(position) { ... });\n</code></pre></div>\n<p>But we can use the dot syntax to chain our property/method access together, reducing the number of lines we have to write.</p>\n<p>The <a href=\"/pt-BR/docs/Web/API/Geolocation/getCurrentPosition\"><code>Geolocation.getCurrentPosition()</code></a> method only has a single mandatory parameter, which is an anonymous function that will run when the device's current position has been successfully retrieved. This function itself has a parameter, which contains a <a href=\"/pt-BR/docs/Web/API/GeolocationPosition\"><code>Position</code></a> object representing the current position data.</p>\n<div class=\"notecard note\">\n <p><strong>Nota:</strong> A function that is taken by another function as an argument is called a <a href=\"/pt-BR/docs/Glossary/Callback_function\">callback function</a>.</p>\n</div>\n<p>This pattern of invoking a function only when an operation has been completed is very common in JavaScript APIs — making sure one operation has completed before trying to use the data the operation returns in another operation. These are called <strong><a href=\"/pt-BR/docs/Glossary/Asynchronous\">asynchronous</a> operations</strong>. Because getting the device's current position relies on an external component (the device's GPS or other geolocation hardware), we can't guarantee that it will be done in time to just immediately use the data it returns. Therefore, something like this wouldn't work:</p>\n<div class=\"code-example\"><div class=\"example-header\"><span class=\"language-name\">js</span></div><pre class=\"brush: js example-bad notranslate\"><code>var position = navigator.geolocation.getCurrentPosition();\nvar myLatitude = position.coords.latitude;\n</code></pre></div>\n<p>If the first line had not yet returned its result, the second line would throw an error, because the position data would not yet be available. For this reason, APIs involving asynchronous operations are designed to use <a href=\"/pt-BR/docs/Glossary/Callback_function\">callback function</a>s, or the more modern system of <a href=\"/pt-BR/docs/Web/JavaScript/Reference/Global_Objects/Promise\">Promises</a>, which were made available in ECMAScript 6 and are widely used in newer APIs.</p>\n<p>We are combining the Geolocation API with a third party API — the Google Maps API — which we are using to plot the location returned by <code>getCurrentPosition()</code> on a Google Map. We make this API available on our page by linking to it — you'll find this line in the HTML:</p>\n<div class=\"code-example\"><div class=\"example-header\"><span class=\"language-name\">html</span></div><pre class=\"brush: html notranslate\"><code><script\n type=\"text/javascript\"\n src=\"https://maps.google.com/maps/api/js?key=AIzaSyDDuGt0E5IEGkcE6ZfrKfUtE9Ko_de66pA\"></script>\n</code></pre></div>\n<p>To use the API, we first create a <code>LatLng</code> object instance using the <code>google.maps.LatLng()</code> constructor, which takes our geolocated <a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Web/API/GeolocationCoordinates/latitude\"><code>Coordinates.latitude</code></a> and <a class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\" href=\"/en-US/docs/Web/API/GeolocationCoordinates/longitude\"><code>Coordinates.longitude</code></a> values as parameters:</p>\n<div class=\"code-example\"><div class=\"example-header\"><span class=\"language-name\">js</span></div><pre class=\"brush: js notranslate\"><code>var latlng = new google.maps.LatLng(\n position.coords.latitude,\n position.coords.longitude,\n);\n</code></pre></div>\n<p>This object is itself set as the value of the <code>center</code> property of an options object that we've called <code>myOptions</code>. We then create an object instance to represent our map by calling the <code>google.maps.Map()</code> constructor, passing it two parameters — a reference to the <a href=\"/pt-BR/docs/Web/HTML/Element/div\"><code><div></code></a> element we want to render the map on (with an ID of <code>map_canvas</code>), and the options object we defined just above it.</p>\n<div class=\"code-example\"><div class=\"example-header\"><span class=\"language-name\">js</span></div><pre class=\"brush: js notranslate\"><code>var myOptions = {\n zoom: 8,\n center: latlng,\n mapTypeId: google.maps.MapTypeId.TERRAIN,\n disableDefaultUI: true,\n};\n\nvar map = new google.maps.Map(document.querySelector(\"#map_canvas\"), myOptions);\n</code></pre></div>\n<p>With this done, our map now renders.</p>\n<p>This last block of code highlights two common patterns you'll see across many APIs. First of all, API objects commonly contain constructors, which are invoked to create instances of those objects that you'll use to write your program. Second, API objects often have several options available that can be tweaked to get the exact environment you want for your program. API constructors commonly accept options objects as parameters, which is where you'd set such options.</p>\n<div class=\"notecard note\">\n <p><strong>Nota:</strong> Don't worry if you don't understand all the details of this example immediately. We'll cover using third party APIs in a lot more detail in a future article.</p>\n</div>"}},{"type":"prose","value":{"id":"possuem_pontos_de_entrada_reconhecíveis","title":"Possuem pontos de entrada reconhecíveis","isH3":true,"content":"<p>When using an API, you should make sure you know where the entry point is for the API. In The Geolocation API, this is pretty simple — it is the <a href=\"/pt-BR/docs/Web/API/Navigator/geolocation\"><code>Navigator.geolocation</code></a> property, which returns the browser's <a href=\"/pt-BR/docs/Web/API/Geolocation\"><code>Geolocation</code></a> object that all the useful geolocation methods are available inside.</p>\n<p>The Document Object Model (DOM) API has an even simpler entry point — its features tend to be found hanging off the <a href=\"/pt-BR/docs/Web/API/Document\"><code>Document</code></a> object, or an instance of an HTML element that you want to affect in some way, for example:</p>\n<div class=\"code-example\"><div class=\"example-header\"><span class=\"language-name\">js</span></div><pre class=\"brush: js notranslate\"><code>var em = document.createElement(\"em\"); // create a new em element\nvar para = document.querySelector(\"p\"); // reference an existing p element\nem.textContent = \"Hello there!\"; // give em some text content\npara.appendChild(em); // embed em inside para\n</code></pre></div>\n<p>Other APIs have slightly more complex entry points, often involving creating a specific context for the API code to be written in. For example, the Canvas API's context object is created by getting a reference to the <a href=\"/pt-BR/docs/Web/HTML/Element/canvas\"><code><canvas></code></a> element you want to draw on, and then calling its <a href=\"/pt-BR/docs/Web/API/HTMLCanvasElement/getContext\"><code>HTMLCanvasElement.getContext()</code></a> method:</p>\n<div class=\"code-example\"><div class=\"example-header\"><span class=\"language-name\">js</span></div><pre class=\"brush: js notranslate\"><code>var canvas = document.querySelector(\"canvas\");\nvar ctx = canvas.getContext(\"2d\");\n</code></pre></div>\n<p>Anything that we want to do to the canvas is then achieved by calling properties and methods of the content object (which is an instance of <a href=\"/pt-BR/docs/Web/API/CanvasRenderingContext2D\"><code>CanvasRenderingContext2D</code></a>), for example:</p>\n<div class=\"code-example\"><div class=\"example-header\"><span class=\"language-name\">js</span></div><pre class=\"brush: js notranslate\"><code>Ball.prototype.draw = function () {\n ctx.beginPath();\n ctx.fillStyle = this.color;\n ctx.arc(this.x, this.y, this.size, 0, 2 * Math.PI);\n ctx.fill();\n};\n</code></pre></div>\n<div class=\"notecard note\">\n <p><strong>Nota:</strong> You can see this code in action in our <a href=\"https://github.com/mdn/learning-area/blob/master/javascript/apis/introduction/bouncing-balls.html\" class=\"external\" target=\"_blank\">bouncing balls demo</a> (see it <a href=\"https://mdn.github.io/learning-area/javascript/apis/introduction/bouncing-balls.html\" class=\"external\" target=\"_blank\">running live</a> also).</p>\n</div>"}},{"type":"prose","value":{"id":"usam_eventos_para_lidar_com_mudanças_de_estado","title":"Usam eventos para lidar com mudanças de estado","isH3":true,"content":"<p>We already discussed events earlier on in the course, in our <a href=\"/pt-BR/docs/Learn/JavaScript/Building_blocks/Events\">Introduction to events</a> article — this article looks in detail at what client-side web events are and how they are used in your code. If you are not already familiar with how client-side web API events work, you should go and read this article first before continuing.</p>\n<p>Some web APIs contain no events, but some contain a number of events. The handler properties that allow us to run functions when events fire are generally listed in our reference material in separate \"Event handlers\" sections. As a simple example, instances of the <a href=\"/pt-BR/docs/Web/API/XMLHttpRequest\"><code>XMLHttpRequest</code></a> object (each one represents an HTTP request to the server to retrieve a new resource of some kind) have a number of events available on them, for example the <code>load</code> event is fired when a response has been successfully returned containing the requested resource, and it is now available.</p>\n<p>O código seguinte fornece um exemplo simples de como isso seria utilizado:</p>\n<div class=\"code-example\"><div class=\"example-header\"><span class=\"language-name\">js</span></div><pre class=\"brush: js notranslate\"><code>var requestURL =\n \"https://mdn.github.io/learning-area/javascript/oojs/json/superheroes.json\";\nvar request = new XMLHttpRequest();\nrequest.open(\"GET\", requestURL);\nrequest.responseType = \"json\";\nrequest.send();\n\nrequest.onload = function () {\n var superHeroes = request.response;\n populateHeader(superHeroes);\n showHeroes(superHeroes);\n};\n</code></pre></div>\n<div class=\"notecard note\">\n <p><strong>Nota:</strong> You can see this code in action in our <a href=\"https://github.com/mdn/learning-area/blob/master/javascript/apis/introduction/ajax.html\" class=\"external\" target=\"_blank\">ajax.html</a> example (<a href=\"https://mdn.github.io/learning-area/javascript/apis/introduction/ajax.html\" class=\"external\" target=\"_blank\">see it live</a> also).</p>\n</div>\n<p>The first five lines specify the location of resource we want to fetch, create a new instance of a request object using the <code>XMLHttpRequest()</code> constructor, open an HTTP <code>GET</code> request to retrieve the specified resource, specify that the response should be sent in JSON format, then send the request.</p>\n<p>The <code>onload</code> handler function then specifies what we do with the response. We know the response will be successfully returned and available after the load event has required (unless an error occurred), so we save the response containing the returned JSON in the <code>superHeroes</code> variable, then pass it to two different functions for further processing.</p>"}},{"type":"prose","value":{"id":"possuem_mecanismos_de_segurança_adicionais_quando_apropriado","title":"Possuem mecanismos de segurança adicionais, quando apropriado","isH3":true,"content":"<p>WebAPI features are subject to the same security considerations as JavaScript and other web technologies (for example <a href=\"/en-US/docs/Web/Security/Same-origin_policy\" class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\">same-origin policy</a>), but they sometimes have additional security mechanisms in place. For example, some of the more modern WebAPIs will only work on pages served over HTTPS due to them transmitting potentially sensitive data (examples include <a href=\"/pt-BR/docs/Web/API/Service_Worker_API\">Service Workers</a> and <a href=\"/pt-BR/docs/Web/API/Push_API\">Push</a>).</p>\n<p>In addition, some WebAPIs request permission to be enabled from the user once calls to them are made in your code. As an example, you may have noticed a dialog like the following when loading up our earlier <a href=\"/pt-BR/docs/Web/API/Geolocation\">Geolocation</a> example:</p>\n<p>\n <img src=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction/location-permission.png\" alt=\"\" width=\"413\" height=\"188\" loading=\"lazy\">\n</p>\n<p>The <a href=\"/en-US/docs/Web/API/Notifications_API\" class=\"only-in-en-us\" title=\"Esta página está disponível apenas em inglês no momento\">Notifications API</a> asks for permission in a similar fashion:</p>\n<p>\n <img src=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction/notification-permission.png\" alt=\"\" width=\"404\" height=\"185\" loading=\"lazy\">\n</p>\n<p>These permission prompts are given to users for security — if they weren't in place, then sites could start secretly tracking your location without you knowing it, or spamming you with a lot of annoying notifications.</p>"}},{"type":"prose","value":{"id":"resumo","title":"Resumo","isH3":false,"content":"<p>Ao chegar aqui, você deve ter uma boa ideia do que são APIs, como funcionam e o que você pode fazer com elas em seu código JavaScript. Além do mais, você deve estar ansioso(a) para colocar a mão na massa e trabalhar com APIs. Na sequência, iremos ver como manipular documentos com o DOM (Document Object Model).</p><ul class=\"prev-next\">\n \n <li><a class=\"button secondary\" href=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs\"><span class=\"button-wrap\"> Menu: APIs web do lado cliente</span></a></li>\n <li><a class=\"button secondary\" href=\"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Manipulating_documents\"><span class=\"button-wrap\"> Próxima </span></a></li>\n</ul>"}}],"toc":[{"text":"O que são APIs?","id":"o_que_são_apis"},{"text":"O que as APIs podem fazer?","id":"o_que_as_apis_podem_fazer"},{"text":"Como as APIs funcionam?","id":"como_as_apis_funcionam"},{"text":"Resumo","id":"resumo"}],"summary":"Primeiro, vamos ver as APIs a partir de um nível mais alto: o que são, como funcionam, como usá-las em seu código e como são estruturadas? Ainda, vamos entender quais são as principais classes de APIs e quais usos elas possuem.","popularity":0.002,"modified":"2024-07-29T19:46:22.000Z","other_translations":[{"locale":"de","title":"Einführung in Web-APIs","native":"Deutsch"},{"locale":"en-US","title":"Introduction to web APIs","native":"English (US)"},{"locale":"es","title":"Introducción a las APIs web","native":"Español"},{"locale":"fr","title":"Introduction aux API web","native":"Français"},{"locale":"ja","title":"Web API の紹介","native":"日本語"},{"locale":"ru","title":"Введение в web APIs","native":"Русский"},{"locale":"zh-CN","title":"Web API 简介","native":"中文 (简体)"}],"pageType":"unknown","source":{"folder":"pt-br/learn/javascript/client-side_web_apis/introduction","github_url":"https://github.com/mdn/translated-content/blob/main/files/pt-br/learn/javascript/client-side_web_apis/introduction/index.md","last_commit_url":"https://github.com/mdn/translated-content/commit/b75339ae65c5d298dfc1f2e3c48547c2839b00d8","filename":"index.md"},"short_title":"Introdução às Web APIs","parents":[{"uri":"/pt-BR/docs/Learn","title":"Aprendendo desenvolvimento web"},{"uri":"/pt-BR/docs/Learn/JavaScript","title":"JavaScript"},{"uri":"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs","title":"APIs web do lado cliente"},{"uri":"/pt-BR/docs/Learn/JavaScript/Client-side_web_APIs/Introduction","title":"Introdução às Web APIs"}],"pageTitle":"Introdução às Web APIs - Aprendendo desenvolvimento web | MDN","noIndexing":false}}</script></body></html>