Make Hono work on Node.js

Hola. Estoy muy emocionado de hablar en Node Congress hoy. El título es Hacer que Hono funcione en Node.js. Vamos a continuar. Mi nombre es Yusuke. Me encanta construir frameworks web. Estoy trabajando en Cloudflare como defensor de desarrolladores. Soy el creador de Hono.

Hoy me gustaría hablar sobre cómo hicimos que Hono funcionara en Node.js. Aquí está la agenda de hoy. Primero, hablaré sobre Hono. A continuación, compartiré cómo comenzó Hono. Luego, explicaré cómo hicimos que Hono funcionara en Node.js y las mejoras de rendimiento. Primero, hablaré sobre qué es Hono. Hono es el backend de los frameworks web para JavaScript. Podemos llamar a Hono la próxima generación de express. Utiliza solo estándares web APIs y funciona en Cloudflare, Castino y Node.js, etcétera. Aquí está la aplicación web Hello World usando Hono. Solo una, dos, tres, cuatro líneas, y esta API es súper simple.

Hono tiene cinco características clave. Primero, es muy rápido, y segundo, el tamaño del paquete es pequeño y funciona en múltiples entornos de ejecución, y puedes agregar muchas características fácilmente usando middleware. Por último, Hono soporta TypeScript como primera clase y proporciona una gran experiencia de desarrollador. Hablaré sobre el comienzo de Hono. Déjame compartir cómo comencé a construir Hono. Estamos creando Hono, quería construir una aplicación para Cloudflare workers, pero en ese momento, no podía encontrar un gran framework para mí. Este IttyRooter es tan simple. No tiene suficientes características para mí y este masterclass y Thunder son buenos frameworks, pero no prefiero la API que es similar a express. Así que decidí hacer mi propio framework. Así es como nació Hono. El commit inicial de Hono fue el 15 de diciembre de 2021, luego Hono comenzó.

Hace más de tres años. En ese momento, Hono fue construido con WebStandard API y era solo para Cloudflare workers. Así que, realmente no podíamos decir que es multi-runtime aún. Hablaré sobre cómo Hono soporta múltiples entornos de ejecución.

Lanzamos la versión 2 de Hono el 16 de junio de 2022. En la versión 2, Hono comenzó a soportar Dno y BAN. No dijimos que Hono soporta Dno y BAN antes de la versión 2, pero era fácil soportarlos porque tanto Dno como BAN utilizan WebStandard APIs.

Para soportar Dno, necesitamos hacer dos cosas. En Dno, para importar un módulo, tuvimos que agregar una extensión como .ts o .ds, el nombre del módulo. Y segundo, Dno importa módulos usando URLs. Así que, hicimos un paquete de Hono que se puede descargar desde Dno.runx. Soportar BAN fue muy fácil. Después de que BAN se hizo público, alguien creó este problema y ¿hay algún plan para el soporte de BAN.js? Pero no tenemos que hacer nada. Hono simplemente funciona en BAN sin ningún cambio.

Aquí hay algo interesante. El mismo código puede ejecutarse en Cloudflare y BAN. Este ejemplo es solo una aplicación hello world y puedes aprenderlo. Comandos de desarrollo de lenguaje para Cloudflare workers y comando BAN para BAN. Así que, completamente igual para la aplicación hello world que comenzó como Cloudflare workers y BAN. Por lo tanto, podemos decir que Hono es un framework multi-runtime.

Convertirse en multi-runtime tuvo grandes beneficios. Cuando Hono comenzó a soportar multi-runtime, más personas comenzaron a usarlo. Esto significó que obtuvimos más retroalimentación, problemas y casos de uso. Al abordar esto, mejoramos la calidad de Hono. Así que, aprender Hono en multi-runtime ha llevado a muy buenos resultados para nosotros. A continuación, explico el adaptador de Node.js. Después de soportar DNO y BAN en la versión 2, nuestro próximo gran desafío fue hacer que Hono funcionara en Node.js. Porque muchas personas usan Node.js, así que si tiene éxito, Hono alcanzaría a muchos más usuarios. Pero la aplicación Hono no puede ejecutarse en Node.js tal como está. Node.js tiene APIs estándar web como fetch y request response URL y etcétera.

Pero si construyes un servidor web, necesitas APIs específicas de Node.js. Aquí hay un ejemplo de aplicación Hono para Node.js. Como puedes ver, este objeto es un mensaje de entrada HTTP y la respuesta del servidor HTTP. Esta API de Node.js, son diferentes de la API estándar web. Así que, tienes que usar estos objetos en lugar de la API estándar web para la aplicación de Node.js.

Para resolver esto, creamos el adaptador de Node.js. Este se publica como un paquete npm llamado .machono. Esto convierte la API de Node.js en una API estándar web. Transforma el mensaje de entrada HTTP de Node.js en un objeto de solicitud estándar web y lo pasa a la aplicación Hono. Y luego la aplicación Hono devuelve el objeto de respuesta y lo convierte en la respuesta del servidor HTTP de Node.js. Esta área es la aplicación Hono, el adaptador de Node.js de Hono. Este adaptador puedes ejecutar tu aplicación Hono en Node.js. Esta es una implementación interna del adaptador. Este fallback significa la aplicación Hono. Recibe el objeto de solicitud y devuelve el objeto de respuesta. El adaptador convierte el objeto de mensaje de entrada de Node.js en un objeto de solicitud y lo pasa a la aplicación de Hono. Luego la aplicación Hono devuelve el objeto de respuesta y establece el código de estado y los valores de encabezado y el cuerpo para la respuesta del servidor de Node.js.

Aquí está cómo usas el adaptador de Node.js. Esta es una aplicación Hono muy básica y esta app es una instancia de Hono. Si quieres ejecutarla en Node.js, primero importa un método secundario del adaptador de Hono, el adaptador de Node.js, y pasa la aplicación al método secundario. Es tan simple y puedes ejecutar este código con el comando Node. La creación del adaptador de Node.js funciona muy bien y el conteo de descargas está aumentando. Sin embargo, hay algún costo de rendimiento. Convierte entre el adaptador de Node.js, las APIs de Node.js y las APIs WebStandard. Este costo introduce una degradación del rendimiento. Así que hemos realizado pruebas de referencia para medir el rendimiento. Seguiremos el método descrito en esta URL y hay tres escenarios. Uno es simplemente recibir una solicitud GET y devolver una respuesta hello world. Segundo, devuelve una solicitud GET y captura el parámetro de paso y el parámetro de consulta y devuelve estos valores y añade un encabezado personalizado. El último es pasar el cuerpo JSON de una solicitud POST y devolver el cuerpo JSON serializado.

Aquí hay una aplicación Hono que maneja tres escenarios. Aquí están los resultados de referencia en comparación con algunos frameworks de Node.js. Y BAN y DINO. Estos BAN y DINO son más rápidos que la aplicación de Node.js porque no tienen sobrecargas. Pero entre los frameworks de Node.js, Hono es más rápido que Express. Pero eso es más lento en el núcleo. Y allí hay una gran diferencia con Fastify. Así que no podemos decir que Hono es rápido en Node.js.

Sin embargo, aún Node.js tiene muchos usuarios, así que nuestro adaptador de Node.js terminó siendo utilizado por muchos usuarios. Después de que se lanzó el adaptador de Node.js, después de un tiempo, hicimos una mejora significativa para aumentar el rendimiento. En noviembre de 2023, se creó esta solicitud de extracción titulada reducir la generación de objetos y optimizar el rendimiento. Esta solicitud de extracción aplica principios fundamentales de ajuste de rendimiento. No hagas cosas hasta que sean necesarias. Nos dimos cuenta de que crear objetos de solicitud y respuesta usando new request y new response es muy lento. Para resolver esto, introdujimos objetos de solicitud livianos y objetos de respuesta livianos. Normalmente, estos objetos livianos se utilizan si no es necesario leer el cuerpo. Por ejemplo, acceder a propiedades como request, lo siento, objeto de estado y propiedad de estado y propiedad de método. Pero si quieres acceder al cuerpo como leak JSON, leak text y leak alibha, entonces crea el objeto de solicitud.

Esto significa que algunos casos de uso simples como la aplicación Hello World, Hono puede ser extremadamente rápido y una gran cosa sobre esta optimización es que los objetos de solicitud y respuesta livianos no cambian la API. Aquí hay un código simple para implementar la solicitud liviana en el adaptador de Node.js. Este constructor, no crea el objeto de solicitud de inmediato. En cambio, almacena en caché este mensaje entrante. Al acceder a propiedades como método o estado, tampoco crea el objeto de solicitud. Sin embargo, al llamar a JSON o text alibha, que requieren leer el cuerpo, crea el objeto de solicitud por primera vez y lee el cuerpo de él y almacena en caché el objeto de solicitud. Luego, almacena el objeto para el futuro. Así que, la próxima vez, es útil desde este objeto de solicitud en caché. Aprendimos a medir de nuevo usando los mismos escenarios. No hubo mucha diferencia en la referencia de paso del cuerpo JSON, pero vimos una gran mejora en la prueba de ping y consulta. Cada uno de ellos es aproximadamente un 50% más rápido que antes. Vamos a compararlo con otros frameworks.

Anteriormente, Hono era más lento en el núcleo, pero ahora se ha vuelto más rápido. Y siempre se está acercando, también se está acercando a Fastify en rendimiento. Con esto, nuestra optimización de rendimiento está completa. El rendimiento de Hono en Node.js es bastante bueno. Por supuesto, aprender en Cloud-Havercast y Deno es más rápido porque no hay sobrecarga de conversión. Pero Node.js sigue siendo lo suficientemente rápido para casos de uso del mundo real.

Así que, ahora, puedes usar el adaptador de Node.js en producción. Ahora, vamos a concluir la masterclass de hoy. Nos encantan nuevos entornos de ejecución como Cloud-Havercast y Deno y BAN, sin embargo, Node.js todavía es ampliamente utilizado por muchos desarrolladores. Así que, con el adaptador de Node.js, convierte las APIs estándar web en APIs de Node.js. Al usar objetos de solicitud livianos y objetos de respuesta livianos, mejoramos con éxito el rendimiento. Una de las mejores cosas sobre Hono es el soporte para múltiples entornos de ejecución. Así que, esto ayuda a Hono a alcanzar más usuarios y mejorar la calidad de Hono. Agregar soporte para Node.js fue definitivamente una buena decisión.

Así que, esta fue la historia de hacer que Hono funcione en Node.js. Este es el final. Muchas gracias.