Docs
Plugins
Localizations
Examples
Updates
Purchase

Customize error renderer

From v1.6.0, you can use a custom error renderer if the viewer can't load the document by using the `renderError` option. It is a function that takes a `LoadError` parameter and returns an element.
Important note
There's a problem with the minified version of pdf.js' worker v2.5.207. It doesn't throw the exception properly if you use the following worker:
// Does NOT work
<Worker workerUrl="https://unpkg.com/pdfjs-dist@2.5.207/build/pdf.worker.min.js">...</Worker>
The unminified version works:
// Work
<Worker workerUrl="https://unpkg.com/pdfjs-dist@2.5.207/build/pdf.worker.js">...</Worker>
The `LoadError` type consists of two properties:
The `name` property can take one of the values below:
By relying on the `name` property, you can customize the error message as well.
import { LoadError, Viewer } from '@react-pdf-viewer/core';


const renderError = (error: LoadError) => {
    let message = '';
    switch (error.name) {
        case 'InvalidPDFException':
            message = 'The document is invalid or corrupted';
            break;
        case 'MissingPDFException':
            message = 'The document is missing';
            break;
        case 'UnexpectedResponseException':
            message = 'Unexpected server response';
            break;
        default:
            message = 'Cannot load the document';
            break;
    }


    return (
        <div
            style={{
                alignItems: 'center',
                display: 'flex',
                height: '100%',
                justifyContent: 'center',
            }}
        >
            <div
                style={{
                    backgroundColor: '#e53e3e',
                    borderRadius: '0.25rem',
                    color: '#fff',
                    padding: '0.5rem',
                }}
            >
                {message}
            </div>
        </div>
    );
};


<Viewer fileUrl={fileUrl} renderError={renderError} />;
(The sample code)

See also