n8n의 노드 린터인 @n8n/eslint-plugin-community-nodes는 커뮤니티 패키지에 포함된 n8n 노드와 자격 증명의 소스 코드를 정적 분석("린트")합니다. 이 린터는 문제를 감지하고 자동으로 수정하여 모범 사례를 따르도록 도와줍니다.

@n8n/eslint-plugin-community-nodes에는 노드 파일(*.node.ts), 자격 증명 파일(*.credentials.ts), 그리고 커뮤니티 패키지의 package.json에 대한 규칙 모음이 포함되어 있습니다.

설정#

n8n 노드 스타터를 사용하는 경우: 스타터 프로젝트에서 npm install을 실행하여 모든 의존성을 설치합니다. 설치가 끝나면 린터를 사용할 수 있습니다.

VS Code를 사용하는 경우, ESLint VS Code 확장을 설치하세요. 다른 IDE를 사용하는 경우 해당 IDE의 ESLint 통합 기능을 참고하세요.

사용법#

커뮤니티 패키지 또는 메인 n8n 리포지터리에서 린터를 사용할 수 있습니다.

린팅#

커뮤니티 패키지에서는 의존성 설치 후, 그리고 패키지를 npm에 게시하기 전에 린터가 자동으로 실행됩니다. 메인 n8n 리포지터리에서는 풀 리퀘스트에 푸시할 때마다 GitHub Actions를 사용해 린터가 자동으로 실행됩니다.

두 경우 모두, 프로젝트 작업 중 VS Code가 백그라운드에서 린트를 수행합니다. 감지된 문제 위로 마우스를 올리면 린트에 대한 전체 설명과 추가 정보 링크를 볼 수 있습니다.

린터를 수동으로 실행할 수도 있습니다.

• npm run lint를 실행하면 린트를 수행하고 콘솔에서 감지된 문제를 확인할 수 있습니다.
• npm run lint:fix를 실행하면 린트를 수행하고 문제를 자동으로 수정합니다. 린터는 자동 수정 가능으로 표시된 규칙 위반을 수정합니다.

두 명령 모두 커뮤니티 패키지의 루트 디렉터리 또는 메인 리포지터리의 /packages/nodes-base/에서 실행할 수 있습니다.

예외#

규칙 위반을 수정하는 대신, 예외를 만들어 린터가 이를 표시하지 않도록 할 수도 있습니다.

VS Code에서 린트 예외를 만들려면: 문제 위로 마우스를 올리고 Quick fix(macOS에서는 cmd+.)를 클릭한 다음 Disable {rule} for this line을 선택하세요. 타당한 이유가 있는 줄에서만 규칙을 비활성화하세요. 린터가 문제를 잘못 보고하고 있다고 생각되면 n8n 리포지터리에 신고해 주세요.

단일 파일에 린트 예외를 추가하려면 코드 주석을 추가하세요. 자세한 안내는 ESLint 문서를 참고하세요.