멋진 커뮤니티 모듈

몸짓 광대극

포괄적이고 컴팩트 한 MIME 유형 모듈입니다.

빌드 상태

버전 2 참고

버전 2는 semver가 암시하는 것처럼 1.x에서 획기적인 변경 사항입니다.

  • lookup() 이름이 getType()
  • extension() 이름이 getExtension()
  • charset()load()방법이 제거되었습니다.

이 모듈의 레거시 버전을 선호하는 경우 여기npm install mime@^1 에서 버전 1 문서를 찾을 수 있습니다 .

설치

NPM

1
npm install mime

Browser

당신이 같은 들러 등을 사용하는 것이 좋습니다 웹팩 또는 browserify 코드를 패키지로하지만, 브라우저 준비 버전은 정식 버전에 대한 예 wzrd.in. 통해 사용할 수 있습니다. :

1 2 3 4
<script src="https://wzrd.in/standalone/mime@latest"></script> <script> mime.getType(...); // etc. <script>

또는 mime/lite버전 :

1 2 3 4
<script src="https://wzrd.in/standalone/mime%2flite@latest"></script> <script> mimelite.getType(...); // (Note `mimelite` here) <script>

빠른 시작

정식 버전의 경우 (800+ MIME 유형, 1,000+ 확장) :

1 2 3 4 5
const mime = require('mime'); mime.getType('txt'); // ⇨ 'text/plain' mime.getExtension('text/plain'); // ⇨ 'txt'

참조 마임 API API에 대한 자세한 내용은 아래를.

라이트 버전

공급 업체별 ( */vnd.*) 및 실험적 ( */x-*) 유형 을 생략 한이 모듈의 "라이트"버전도 있습니다. 전체 버전의 8KB에 비해 무게는 ~ 2.5KB입니다. 라이트 버전을로드하려면 다음 단계를 따르세요.

1
const mime = require('mime/lite');

Mime .vs. mime-types .vs. mime-db 모듈

이 [인기있는] NPM 모듈의 차이점에 대해 궁금한 분들을 위해 다음은 간단한 요약입니다.

mime-db MIME 유형 정보에 대한 "진실의 소스"입니다. API가 아닙니다. 오히려 IANA, Apache, NGINX에서 가져온 MIME 유형 정의 및 Node.js 커뮤니티에서 제출 한 사용자 지정 매핑의 표준 데이터 세트입니다.

mime-typesAPI와 호환되는 (ish) API 드롭 인을 제공하는 mime-db 주변의 얇은 래퍼 mime @ < v1.3.6입니다.

mimev2부터는 mime-db데이터 세트 의 사전 최적화 된 버전과 함께 번들로 제공되는 자체 포함 모듈 입니다. 다음과 같은 특징을 가진 단순화 된 API를 제공합니다.

  • 지능적으로 해결 된 유형 충돌 (자세한 내용은 mime-score 참조)
  • 업계 모범 사례와 일치하는 메서드 이름 지정
  • 소형 풋 프린트 예 : 다양한 모듈의 축소 및 압축 크기 :
기준 치수 크기
mime-db 18KB
mime-types mime-db와 동일
mime 8KB
mime/lite 2KB

Mime API

모두 require('mime')require('mime/lite')는 MIME 클래스의 반환 인스턴스는, 아래의 문서화.

new Mime(typeMap, ... more maps)

이 모듈의 대부분의 사용자는 Mime 인스턴스를 직접 만들 필요가 없습니다. 그러나 사용자 지정 매핑을 만들려면 다음과 같이 할 수 있습니다.

1 2 3 4 5 6 7 8 9 10 11 12 13 14
// Require Mime class const Mime = require('mime/Mime'); // Define mime type -> extensions map const typeMap = { 'text/abc': ['abc', 'alpha', 'bet'], 'text/def': ['leppard'] }; // Create and use Mime instance const myMime = new Mime(typeMap); myMime.getType('abc'); // ⇨ 'text/abc' myMime.getExtension('text/def'); // ⇨ 'leppard'

둘 이상의 map 인수가 제공되면 각 맵이 define()순서대로 ed (아래 참조)됩니다.

mime.getType(pathOrExtension)

주어진 경로 또는 확장에 대한 MIME 유형을 가져옵니다.

1 2 3 4 5 6 7 8 9
mime.getType('js'); // ⇨ 'application/javascript' mime.getType('json'); // ⇨ 'application/json' mime.getType('txt'); // ⇨ 'text/plain' mime.getType('dir/text.txt'); // ⇨ 'text/plain' mime.getType('dir\\text.txt'); // ⇨ 'text/plain' mime.getType('.text.txt'); // ⇨ 'text/plain' mime.getType('.txt'); // ⇨ 'text/plain'

null 확장자가 감지되지 않거나 인식되지 않는 경우 반환됩니다.

1 2 3
mime.getType('foo/txt'); // ⇨ null mime.getType('bogus_type'); // ⇨ null

mime.getExtension(type)

지정된 MIME 유형에 대한 확장을 가져옵니다. Charset 옵션 (종종 Content-Type 헤더에 포함됨)은 무시됩니다.

1 2 3 4
mime.getExtension('text/plain'); // ⇨ 'txt' mime.getExtension('application/json'); // ⇨ 'json' mime.getExtension('text/html; charset=utf8'); // ⇨ 'html'

mime.define(typeMap[, force = false])

[추가] 유형 매핑을 정의합니다.

typeMapnew Mime위의에 설명 된대로 유형-> 확장의 맵입니다 .

이미 다른 유형에 할당 된 확장에 유형을 매핑하려고하면 기본적으로이 방법은 오류가 발생합니다. 전달 true에 대해 force이 동작 (이전 매핑을 무시)를 억제한다 인수입니다.

1 2 3 4 5
mime.define({'text/x-abc': ['abc', 'abcd']}); mime.getType('abcd'); // ⇨ 'text/x-abc' mime.getExtension('text/x-abc') // ⇨ 'abc'

명령 줄

1
mime [path_or_extension]

1 2
> mime scripts/jquery.js application/javascript

Markdown에서 생성 된 src/README_js.md 으로 RunMD 로고