Me parece increíble la cantidad de significados diferentes que podemos obtener de menos de 30 caracteres. Me refiero al alfabeto con algunos signos de puntuación bien colocados, por supuesto. Desde una historia de amor hasta un programa informático, la escritura nos ha permitido crear mundos extraordinariamente diferentes. Y el lenguaje, en general, proporciona un marco en el que podemos colgar una corriente de ideas.
La mayoría de los lenguajes de programación parecen tener normas muy estrictas: ciertos términos tienen que usarse en ciertos lugares. Pero un área en la que hay una enorme libertad es cómo nombramos esos términos.
Toma este sencillo programa que crea una frase a partir de una matriz de palabras, añade un signo de puntuación y la registra en la consola:
Nada demasiado especial, ¿verdad? Pero lo que quizá no hayas tenido en cuenta es la cantidad de términos que eras responsable de nombrar.
Hay 23 palabras (sin incluir los valores codificados) en el programa anterior. Controlamos los nombres de 14 de esas palabras. Es decir, más del 60% de lo que se tecleó, ¡fue nuestra responsabilidad nombrarlo!
Si usted está construyendo una aplicación empresarial o un simple Hello, World, quieres que tu programa se lea como un Bestseller del Times, no como un libro de ejercicios de Mad Libs.
Esto no es un manifiesto sobre cómo estructurar toda una aplicación JavaScript, sino más bien un capítulo sobre cómo elegir nombres para aquellas cosas en las que tienes libertad para hacerlo. He incluido las distintas referencias al final si quieres saber más. Una última cosa, la clave de todas nuestras convenciones y estándares es esta:
La mayoría de estas convenciones no son para ti hoy, sino para ti y la gente que lea tu código mañana.
Referencias y aprendizaje continuado
- «Clean Code» de Robert C. Martin – Una gran lectura para todos los lenguajes. Va más allá de las convenciones de nombres y propone toda la estructura de tu programa. Los ejemplos son en Java, pero los principios se aplican a JavaScript.
- «Clean Code JavaScript» por Ryan Mcdermott – El libro anterior, pero rehecho para JavaScript. Está disponible en línea y es gratuito.
- Guía de estilo de JavaScript de Airbnb – Posiblemente la guía de estilo más completa para JavaScript. Contiene no sólo el qué, sino también el por qué. (Si estás en un dispositivo pequeño, puede que tengas que hacer clic en «ver todo el léame» para ver el documento completo).
- Guía de estilo de JavaScript W3 – Una guía breve y concisa.
- Guía de estilo ES6 de Google – La guía de estilo de Google para JavaScript.
Gracias por leer!
woz
Sígueme en Twitter.