...master 2026-11-10 (4e7201cfc+unstaged)

Document

MuPDF can open many document types such as PDF, XPS, CBZ, EPUB, FictionBook 2 and a handful of image formats.

class Document()

You cannot create instances of this class with the new operator!

Constants

Permission flags for Document.prototype.hasPermission:

Document.PERMISSION_PRINT

"print" – Print the document.

Document.PERMISSION_EDIT

"edit" – Modify the contents of the document by operations other than those controlled by the other flags: (annotate, form, assemble).

Document.PERMISSION_COPY

"edit" – Copy or otherwise extract text from the document.

Document.PERMISSION_ANNOTATE

"annotate" – Add or modify annotations.

Document.PERMISSION_FORM

"form" – Fill in existing form fields.

Document.PERMISSION_ACCESSIBILITY

"accessibility" – Copy or otherwise extract text from the document in support of accessibility.

Document.PERMISSION_ASSEMBLE

"assemble" – Insert, rotate, or delete pages and create bookmarks.

Document.PERMISSION_PRINT_HQ

"print-hq" – Print the document to a representation from which a faithful digital copy of the PDF content could be generated.

Static methods

Document.openDocument(filename)

Document.openDocument(filename, dir)

Document.openDocument(filename, accelerator, dir)

Document.openDocument(buffer, magic)

Document.openDocument(buffer, magic, acceleratorbuffer)

Document.openDocument(buffer, magic, acceleratorbuffer, dir)

Open the named or given document.

var document1 = mupdf.Document.openDocument("my_pdf.pdf", "application/pdf")
var document2 = mupdf.Document.openDocument("my_pdf.pdf", dir)
var document3 = mupdf.Document.openDocument("my_pdf.pdf", acceleratorfile, dir)
var document4 = mupdf.Document.openDocument(fs.readFileSync("my_pdf.pdf"), "application/pdf")
var document5 = mupdf.Document.openDocument(fs.readFileSync("my_pdf.pdf"), acceleratorbuffer, "application/pdf")
var document6 = mupdf.Document.openDocument(fs.readFileSync("my_pdf.pdf"), acceleratorbuffer, dir, "application/pdf")

Document.recognize(magic)

Document.recognizeContent(filename)

Document.recognizeContent(buffer, magic)

Document.recognizeContent(buffer, dir, magic)

Check if MuPDF can open a document with the provided magic, or with the contents in the given file/buffer.

var recognized1 = mupdf.Document.recognize("application/pdf")
var recognized2 = mupdf.Document.recognizeContent("my_pdf.pdf")
var recognized3 = mupdf.Document.recognizeContent(buffer, "application/pdf")
var recognized4 = mupdf.Document.recognizeContent(buffer, dir, "application/pdf")

Instance methods

Document.prototype.needsPassword()

Returns true if a password is required to open a password protected PDF.

var needsPassword = document.needsPassword()

Document.prototype.authenticatePassword(password)

Returns a bitfield value against the password authentication result.

Bitfield value Description
0 Failed
1 No password needed
2 Is User password and is okay
4 Is Owner password and is okay
6 Is both User & Owner password and is okay
var auth = document.authenticatePassword("abracadabra")

Document.prototype.hasPermission(permission)

Check if a user is allowed permission to perform certain operations on the document.

See Document.PERMISSION_PRINT, etc.

var canEdit1 = document.hasPermission("edit")
var canEdit2 = document.hasPermission(Document.PERMISSION_EDIT)

Document.prototype.getMetaData(key)

Return various meta data information. The common keys are: format, encryption, info:ModDate, and info:Title. Returns undefined if the meta data does not exist.

var format = document.getMetaData("format")
var modificationDate = doc.getMetaData("info:ModDate")
var author = doc.getMetaData("info:Author")

Document.prototype.setMetaData(key, value)

Set document meta data information field to a new value.

document.setMetaData("info:Author", "My Name")

Document.prototype.isReflowable()

Returns true if the document is reflowable, such as EPUB, FB2 or XHTML.

var isReflowable = document.isReflowable()

Document.prototype.style(publisherCSS, userCSS)

Control publisher styles and user stylesheet on a reflowable document.

document.style(false, "p { margin: 0; text-indent: 1em; }")

Document.prototype.layout(pageWidth, pageHeight, fontSize)

Layout a reflowable document (EPUB, FictionBook2, HTML or XHTML) to fit the specified page and font sizes.

document.layout(300, 300, 16)

Document.prototype.countPages()

Count the number of pages in the document. This may change if you call the layout function with different parameters.

var numPages = document.countPages()

Document.prototype.loadPage(number)

Returns a Page object for the given page number.

For documents where Document.prototype.isPDF() returns true, the returned Page is of the subclass PDFPage.

var page = document.loadPage(0) // loads the 1st page of the document

Document.prototype.loadOutline()

Returns an array with the outline (also known as table of contents or bookmarks). In the array is an object for each heading with the property ‘title’, and a property ‘page’ containing the page number. If the object has a ‘down’ property, it contains an array with all the sub-headings for that entry.

var outline = document.loadOutline()

Document.prototype.outlineIterator()

Returns an OutlineIterator for the document outline.

var obj = document.outlineIterator()

Resolve a document internal link URI to a page index.

var pageNumber = document.resolveLink(my_link)

Resolve a document internal link URI to a link destination.

var linkDestination = document.resolveLinkDestination(linkuri)

Document.prototype.isPDF()

Returns true if the document is a PDFDocument.

var isPDF = document.isPDF()

Document.prototype.asPDF()

Returns a PDF version of the document (if possible). PDF documents return themselves. Documents that have an underlying PDF representation return that. Other document types return null.

var doc = mupdf.Document.openDocument(filename)
var pdf = doc.asPDF()
if (pdf) {
        // the document has a native PDF representation
} else {
        // it does not have a native PDF representation
}

Document.prototype.formatLinkURI(linkDestination)

Format a document internal link destination object to a URI string suitable for Page.prototype.createLink().

var uri = document.formatLinkURI({
        chapter: 0,
        page: 42,
        type: "FitV",
        x: 0,
        y: 0,
        width: 100,
        height: 50,
        zoom: 1
})
page.createLink([0, 0, 100, 100], uri)