MDN, tu referencia diaria
MDN Web Docs (developer.mozilla.org) es la referencia más usada de JavaScript, HTML y CSS. La mantienen Mozilla y la comunidad, y es gratuita. Tiene dos tipos de páginas:
- Guías: explican un tema de principio a fin, como un tutorial.
- Referencia: una página por cada pieza del lenguaje, por ejemplo una para el método
at()de los arrays y otra paraconsole.log(). Son las que vas a consultar más.
Las partes de una página de referencia
Todas las páginas de referencia siguen el mismo orden. Cuando lo conoces, encuentras lo que buscas en segundos:
- Resumen y ejemplo interactivo: qué hace, en una o dos frases, y un ejemplo que puedes editar ahí mismo.
- Sintaxis: cómo se escribe la llamada.
- Parámetros: qué le puedes pasar y qué significa cada cosa.
- Valor devuelto: qué obtienes al usarlo.
- Descripción: los detalles y los casos especiales.
- Ejemplos: usos reales, del más simple al más complejo.
- Especificaciones y compatibilidad con navegadores: de dónde viene y dónde funciona.
Por ejemplo, en la página de at() de los arrays, la sintaxis dice:
at(index)
Y en Parámetros explica que index es un número entero y que, si es negativo, cuenta desde el final. Ese detalle es justo lo que vas a necesitar en el laboratorio de abajo.
Cuando un método tiene parámetros opcionales, MDN muestra todas las formas posibles una debajo de otra:
slice()
slice(start)
slice(start, end)
Baseline: ¿lo puedo usar ya?
JavaScript suma novedades cada año, y los navegadores tardan un tiempo en implementarlas. Arriba de cada página, MDN muestra una etiqueta Baseline:
| Etiqueta | Qué significa |
|---|---|
| Ampliamente disponible | Funciona en todos los navegadores principales desde hace al menos 30 meses. Úsalo sin dudar. |
| Disponible recientemente | Ya funciona en todos los navegadores principales, pero desde hace poco. Puede que alguien con un navegador viejo no lo tenga. |
| Disponibilidad limitada | Todavía falta en al menos un navegador principal. Revisa la tabla de compatibilidad antes de usarlo. |
Al final de la página, la tabla de compatibilidad detalla desde qué versión de cada navegador funciona. Para Node.js, la tabla también indica la versión. El sitio caniuse.com ofrece la misma información, con búsqueda rápida.
La especificación oficial
Detrás de MDN está la especificación ECMA-262, el documento oficial de ECMAScript que mantiene el comité TC39. Puedes leerla en tc39.es/ecma262. Es muy precisa, pero está escrita para quienes construyen motores, no para aprender.
Para curiosear lo que viene, en github.com/tc39/proposals está la lista de propuestas con su etapa actual.
Cómo buscar
- Agrega mdn a tu búsqueda:
mdn array at,mdn string replaceall. Llegas directo a la referencia. - Busca por lo que quieres hacer cuando no sabes el nombre:
mdn javascript ordenar arrayte lleva asort()ytoSorted(). - Desconfía de lo viejo: si un tutorial usa
varen todo el código, probablemente es anterior a 2015. Contrasta con MDN. - Prueba antes de dar algo por cierto: la consola está a un atajo de distancia.
Resumen
- MDN es tu referencia diaria: guías para aprender, referencia para consultar.
- Las páginas de referencia siempre siguen el mismo orden: resumen, sintaxis, parámetros, valor devuelto, descripción, ejemplos y compatibilidad.
- Baseline te dice si ya puedes usar algo en todos los navegadores.
- La fuente oficial es ECMA-262, y las novedades en camino están en las propuestas de TC39.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Leer una página de referencia
Resuelto
Elige una respuesta en cada pregunta.
En MDN, ¿qué significa la etiqueta Baseline · ampliamente disponible (Widely available)?
En la página de MDN de un método, ¿en qué sección buscas lo que te devuelve?
¿Cuál es la especificación oficial del lenguaje?
Quieres entender
mapde los arrays. ¿Qué búsqueda te lleva más rápido a la referencia?
Laboratorio: Usa un método leyendo su documentación
Resuelto
Usa el método at() para mostrar el último lenguaje de la lista. Todavía no viste los arrays, y está bien: el ejercicio es leer la documentación y aplicarla. Si te trabas, busca «mdn array at» o pide una pista.
$ node programa.js
Lo que debe cumplir
- Imprime el último elemento:
TypeScript(pendiente) - Usa el método
at()(pendiente) - Usa un índice negativo, como dice la documentación (pendiente)
Una solución
1const lenguajes = ["HTML", "CSS", "JavaScript", "TypeScript"];2 3console.log(lenguajes.at(-1));La documentación de at() dice que acepta un número entero y que, si es negativo, cuenta desde el final del array. Por eso at(-1) es el último elemento, sin importar cuántos haya. Antes de ES2022 había que escribir lenguajes[lenguajes.length - 1].