#mime #classifier #sniffer #media-type #guesser

mime_classifier

Servo's MIME Classifier / Media Type sniffer as a Rust library

1 unstable release

0.0.1 Apr 11, 2022

#16 in #sniffer

Download history 383/week @ 2024-02-26 94/week @ 2024-03-04 175/week @ 2024-03-11 316/week @ 2024-03-18 448/week @ 2024-03-25 132/week @ 2024-04-01 6/week @ 2024-04-08 48/week @ 2024-04-15 14/week @ 2024-04-22 194/week @ 2024-04-29 15/week @ 2024-05-06 134/week @ 2024-05-13 42/week @ 2024-05-20 59/week @ 2024-05-27 20/week @ 2024-06-03 67/week @ 2024-06-10

201 downloads per month
Used in 3 crates (via iroh-gateway)

MPL-2.0 license

41KB
1K SLoC

MIME Classifier / Media Type Sniffer

This crate exposes the MIME Classifier from the Servo web engine as a standalone library.

It implements the WHATWG MIME Sniffing standard to guess the Media Type (also known as MIME type) of a resource from its content. It enables browsers to properly interpret a server response even when the Content-Type header is missing or invalid.

The current version of the library was extracted at the date 2022-04-11 from the commit 8d684eff7d6f8815422cb4c30b43df0035c5069a. If you are a member of the Servo and wish to maintain this library yourself, I'd be glad to transfer ownership of the crate: please open a GitHub issue or send me an email.

Usage

use mime_classifier::{ApacheBugFlag, LoadContext, MimeClassifier, NoSniffFlag};

pub fn main() {
    // Create a classifier using default configuration
    let classifier = MimeClassifier::new();
    // Select the context, this is used to help the classifier based on where
    // the resource is loaded from. `Browsing` corresponds to simply typing
    // the URL in the address bar.
    let context = LoadContext::Browsing;
    // Flag indicating that sniffing should be avoided. This usually corresponds
    // to the server sending the header value `X-Content-Type-Options = "nosniff"`
    // but may also be applied automatically by the browser (e.g. `fetch` API)
    let no_sniff_flag = NoSniffFlag::Off;
    // Enable workaround for an Apache bug when server incorrectly sends a
    // `text/plain` or similar `Content-Type`.
    // See <https://mimesniff.spec.whatwg.org/#ref-for-check-for-apache-bug-flag>
    let apache_bug_flag = ApacheBugFlag::Off;
    // `Content-Type` set by the server, if any
    let supplied_type: Option<mime::Mime> = None;
    // Response body to classify
    let body: &[u8] = include_bytes!("../servo_logo.png");

    let computed_type = classifier.classify(context, no_sniff_flag, apache_bug_flag, &supplied_type, body);
    assert_eq!(computed_type, mime::IMAGE_PNG);
}

License

Code in this crate retains its original Mozilla Public License, version 2.0 (MPL-2.0) license from the Servo project.

Dependencies

~0.4–1MB
~24K SLoC