멋진 커뮤니티 모듈

몸짓 광대극

포괄적이고 컴팩트 한 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 세부 사항은 아래의 Mime 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 및 Node.js 커뮤니티에서 제출 한 사용자 지정 매핑에서 가져온 MIME 유형 정의의 표준 데이터 세트입니다. .

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

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

  • 지능적으로 해결 된 유형 충돌 (자세한 내용은 mime-score 참조)
  • 업계 모범 사례와 일치하는 메서드 이름 지정
  • Compact footprint. Eg The minified+compressed sizes of the various modules :
기준 치수 크기
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'

둘 이상의 맵 인수가 제공되면 각 맵이 순서대로 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])

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

typeMap 은 위의 new Mime 설명 된대로 유형-> 확장의 맵입니다.

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

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

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