n8n 노드 린터

n8n 노드 린터를 사용해 커뮤니티 패키지의 노드와 자격 증명 소스 코드를 정적 분석하고 자동으로 수정하는 방법을 설명합니다.

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 통합 기능을 참고하세요. Note 구성 파일을 편집하지 마세요 eslint.config.mjs 에는 @n8n/node-cli 에서 제공하는 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 문서 를 참고하세요.