Depurar la lógica del servidor

Para ayudar a validar y solucionar problemas de la lógica del servidor durante el desarrollo, Power Pages proporciona una experiencia de depuración local ligera en el escritorio de Visual Studio Code. Esta funcionalidad de depuración le permite establecer puntos de interrupción, recorrer el código e inspeccionar variables sin implementarlas en el sitio activo.

Aunque el entorno de tiempo de ejecución se simula parcialmente, permite una iteración de desarrollo más rápida y una validación temprana de la lógica del servidor antes de la implementación. En este artículo se explica cómo depurar la lógica del servidor, qué funcionalidad se admite durante la depuración y limitaciones importantes para comprender.

Prerequisites

Antes de empezar a depurar la lógica del servidor, asegúrese de que tiene:

• Un sitio de Power Pages con lógica de servidor configurada
• Escritorio de Visual Studio Code instalado en el equipo
• Extensión de Visual Studio Code Power Pages instalada
• Código fuente de lógica del servidor abierto en el escritorio de Visual Studio Code

Iniciar sesión de depuración

La depuración lógica del servidor de Power Pages se habilita a través de un método auxiliar de depuración que proporciona automáticamente la extensión Visual Studio Code de Power Pages.

1. Abra el archivo JavaScript lógico del servidor en Visual Studio Code Desktop.

2. Pegue el nombre del método que desea iniciar la depuración al final del archivo lógico del servidor.

   Ejemplo: get();

   Una vez agregado el método, Visual Studio Code reconoce el archivo como lógica de servidor que se puede depurar.

3. Seleccione el botón Depurar o Ejecutar que aparece al principio del archivo.

4. Establezca puntos de interrupción en las líneas necesarias en el código lógico del servidor.

La sesión de depuración comienza, y la ejecución se detiene en tus puntos de interrupción, permitiéndote inspeccionar variables y avanzar paso a paso por el código.

Comprender el modelo de depuración

La depuración de la lógica del servidor en Power Pages utiliza un entorno de ejecución simulado. Esto significa que la experiencia de depuración local no replica completamente el entorno de ejecución en vivo de Power Pages. Comprender lo que se admite y lo que se simula le ayuda a interpretar los resultados de depuración con precisión.

Se admite durante la depuración

La siguiente funcionalidad admite la ejecución real durante la depuración local:

• HttpClient: este es el único objeto que admite la ejecución real. Las llamadas HTTP realizadas con este cliente se comportan de forma similar a la ejecución en tiempo de ejecución y se conectan a puntos de conexión externos.

Simulado durante la depuración

Todos los demás objetos lógicos de servidor se simulan y devuelven valores predefinidos sin conectarse a servicios activos. Los objetos simulados incluyen (pero no se limitan a):

• Sitio web
• Configuración del Sitio
• Usuario
• Dataverse
• Logger
• Context

Estos objetos ficticios permiten probar la estructura de código y el flujo lógico sin necesidad de conexiones dinámicas ni afectar a los datos de producción.

Personalización de valores ficticios en tiempo de ejecución

Para simular escenarios reales con mayor precisión durante la depuración, puede modificar los valores ficticios predefinidos usados por el entorno de ejecución local. Esto le permite probar diferentes rutas lógicas y casos límite sin implementar la lógica del servidor en un sitio activo.

1. En el proyecto, abra el archivo siguiente:

   .vscode/server-logic-debug-runtime.js

2. Actualice los valores predefinidos de los objetos ficticios según sea necesario para que coincidan con los escenarios de prueba.

3. Guarde el archivo.

4. Reinicie la sesión de depuración para aplicar los valores ficticios actualizados.

Los nuevos valores ficticios se usan en sesiones de depuración posteriores, permitiéndole validar diferentes rutas y condiciones de código.

Limitaciones y consideraciones

Al depurar la lógica del servidor localmente, tenga en cuenta las siguientes limitaciones:

• La experiencia de depuración no se asocia ni interactúa con el entorno de tiempo de ejecución en vivo de Power Pages.
• La depuración solo está disponible en el escritorio de Visual Studio Code, no en versiones basadas en navegador de Visual Studio Code.
• La mayoría de los objetos de servidor son ficticios y devuelven valores estáticos en lugar de conectarse a servicios activos.
• Los resultados observados durante la depuración local pueden diferir del comportamiento de producción debido al entorno de ejecución simulado.
• Use la depuración local principalmente para validar la estructura de código, el flujo lógico y las operaciones de cliente HTTP. Pruebe siempre la lógica de servidor implementada en un entorno de desarrollo o prueba antes de pasar a producción.

Pasos siguientes

Después de depurar la lógica del servidor localmente, implemente y pruebe el código en un entorno de Power Pages que no sea de producción para validar el comportamiento en el entorno en tiempo de ejecución real.