Configuración de utilidades para el tiempo de ejecución de APPSYNC_JS

AWS AppSync proporciona dos bibliotecas que contribuyen al desarrollo de solucionadores con la versión ejecutable APPSYNC_JS:

• @aws-appsync/eslint-plugin: identifica y soluciona problemas rápidamente durante el desarrollo.

• @aws-appsync/utils: proporciona la validación de tipos y la función de autocompletar en editores de código.

Configuración del complemento de eslint

ESLint es una herramienta que analiza estáticamente su código para encontrar problemas de forma rápida. Puede ejecutar ESLint como parte de su canalización de integración continua. @aws-appsync/eslint-plugin es un complemento de ESLint que detecta la sintaxis no válida en su código al aprovechar la versión ejecutable APPSYNC_JS. El complemento permite recibir comentarios sobre el código de forma rápida durante el desarrollo sin tener que enviar los cambios a la nube.

@aws-appsync/eslint-plugin proporciona dos conjuntos de reglas que puede usar durante el desarrollo.

"plugin:@aws-appsync/base" configura un conjunto básico de reglas que puede aprovechar en su proyecto:

Regla	Descripción
no-async	No se admiten promesas ni procesos asíncronos.
no-await	No se admiten promesas ni procesos asíncronos.
no-classes	No se admiten clases.
no-for	No se admite for (excepto para for-in y for-of, que sí se admiten)
no-continue	No se admite continue.
no-generators	No se admiten generadores.
no-yield	yield no se admite.
no-labels	No se admiten etiquetas.
no-this	No se admite la palabra clave this.
no-try	No se admite la estructura try/catch.
no-while	No se admiten los bucles WHILE.
no-disallowed-unary-operators	No se permiten los operadores unarios ++, -- y ~.
no-disallowed-binary-operators	No se permite el operador instanceof.
no-promise	No se admiten promesas ni procesos asíncronos.

"plugin:@aws-appsync/recommended" proporciona algunas reglas adicionales, pero también requiere que añada configuraciones de TypeScript a su proyecto.

Regla	Descripción
no-recursion	No se permiten llamadas a funciones recursivas.
no-disallowed-methods	No se permiten algunos métodos. Consulte la referencia para obtener un conjunto completo de funciones integradas compatibles.
no-function-passing	No se permite pasar funciones como argumentos de la función a funciones.
no-function-reassign	No se pueden reasignar funciones.
no-function-return	Las funciones no pueden ser el valor devuelto de las funciones.

Para añadir el complemento a su proyecto, siga los pasos de instalación y uso que se indican en Introducción a ESLint. A continuación, instale el complemento en su proyecto con el administrador de paquetes del proyecto (por ejemplo, npm, yarn o pnpm):

$ npm install @aws-appsync/eslint-plugin

En el archivo .eslintrc.{js,yml,json}, añada "plugin:@aws-appsync/base" o "plugin:@aws-appsync/recommended" a la propiedad extends. El siguiente fragmento de código es un ejemplo de configuración .eslintrc básica para JavaScript:

{
  "extends": ["plugin:@aws-appsync/base"]
}

Para usar el conjunto de reglas "plugin:@aws-appsync/recommended", instale la dependencia requerida:

$ npm install -D @typescript-eslint/parser

A continuación, cree un archivo .eslintrc.js:

{
  "parser": "@typescript-eslint/parser",
  "parserOptions": {
    "ecmaVersion": 2018,
    "project": "./tsconfig.json"
  },
  "extends": ["plugin:@aws-appsync/recommended"]
}