jsDoc npm 모듈 퀘스트-JS 튜토리얼-php.cn

jsDoc npm 모듈 퀘스트

PHPz

풀어 주다： 2024-08-30 19:06:25

원래의

526명이 탐색했습니다.

TLDR; jsDoc npm module quest

Typescript npm 모듈은 jsDoc에서 제작되었으며, useDuck은 70LOC에서 redux의 황금기를 되살렸습니다. 개발 시 이 모듈의 주요 사용 사례는 복잡한 상태를 형식 안전으로 유지하는 데 도움이 되는 경우입니다.

jsdoc-duck

jsDoc에 대한 TypeScript로 가는 길

const [state, quack] = useDuck(reducer, initialState, actionsMap);

로그인 후 복사

경량 반응 상태 npm 라이브러리인 React-state-factory를 만들었을 때 TypeScript에 대한 내 경험이 좀 더 깊어졌습니다.

jsDoc 제한 테스트

작업에 도움이 되도록 몇 가지 jsDoc 주석을 사용한 후 다음 단계는 좀 더 야심적입니다. 이 모듈을 jsDoc으로 재작업하는 것입니다. 언뜻보기에 이것은 불가능한 임무입니다. 하지만 몇 주 동안 jsDoc을 이해한 후 터널 끝에서 약간의 빛을 보았습니다.

User declared 
state and actions types 
  -> useStateFactory 
  -> [state, dispatchedActoionCollection]

로그인 후 복사

유형 시스템의 공포: 감속기

리듀서 함수를 작성하려고 할 때 특정 지점에서 jsDoc 기능의 엄격한 한계를 발견했습니다. 결과는 Quack이지만 물론 빈 {}가 시작됩니다. 따라서 리듀서 실행이 끝나면 해당 유형이 요청된 모든 키를 포함하는 객체에 대해 궁금해하기 때문에 적절한 돌팔이가 생성됩니다. 그래서 지금까지 이 문제를 해결할 수 없었습니다. 누군가 이 문제를 해결할 수 있는 좋은 아이디어를 제공할 수 있다면 저와 공유하거나 이 모듈 개발에 공동 작업자로 참여해 주시기 바랍니다.

또 다른 함정: TS가 없으면 모듈에 유형이 없습니다.

처음에는 필요한 모든 jsDoc @typedef가 포함된 단일 js 파일을 생성합니다. 조만간 이것이 작동할 것입니다. 그리고 그 순간 그들을 위한 노드 모듈을 만드는 한 단계만 생각하면 됩니다.

그러나 슬픈 사실은 내보낸 유형이 포함된 npm 모듈에서는 jsDoc에서만 작동하지 않으므로 d.ts를 컴파일해야 하므로 마지막 jsDoc 모듈에서는 100% JS라고 말하지 말고 빌드에서는 typescript도 사용합니다.