/* Copyright 2017 Mozilla Foundation * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ import { createResponseStatusError, extractFilenameFromHeader, validateRangeRequestCapabilities, validateResponseStatus } from '../../src/display/network_utils'; import { MissingPDFException, UnexpectedResponseException } from '../../src/shared/util'; describe('network_utils', function() { describe('validateRangeRequestCapabilities', function() { it('rejects range chunk sizes that are not larger than zero', function() { expect(function() { validateRangeRequestCapabilities({ rangeChunkSize: 0, }); }).toThrow(new Error('Range chunk size must be larger than zero')); }); it('rejects disabled or non-HTTP range requests', function() { expect(validateRangeRequestCapabilities({ disableRange: true, isHttp: true, getResponseHeader: (headerName) => { if (headerName === 'Content-Length') { return 8; } }, rangeChunkSize: 64, })).toEqual({ allowRangeRequests: false, suggestedLength: 8, }); expect(validateRangeRequestCapabilities({ disableRange: false, isHttp: false, getResponseHeader: (headerName) => { if (headerName === 'Content-Length') { return 8; } }, rangeChunkSize: 64, })).toEqual({ allowRangeRequests: false, suggestedLength: 8, }); }); it('rejects invalid Accept-Ranges header values', function() { expect(validateRangeRequestCapabilities({ disableRange: false, isHttp: true, getResponseHeader: (headerName) => { if (headerName === 'Accept-Ranges') { return 'none'; } else if (headerName === 'Content-Length') { return 8; } }, rangeChunkSize: 64, })).toEqual({ allowRangeRequests: false, suggestedLength: 8, }); }); it('rejects invalid Content-Encoding header values', function() { expect(validateRangeRequestCapabilities({ disableRange: false, isHttp: true, getResponseHeader: (headerName) => { if (headerName === 'Accept-Ranges') { return 'bytes'; } else if (headerName === 'Content-Encoding') { return 'gzip'; } else if (headerName === 'Content-Length') { return 8; } }, rangeChunkSize: 64, })).toEqual({ allowRangeRequests: false, suggestedLength: 8, }); }); it('rejects invalid Content-Length header values', function() { expect(validateRangeRequestCapabilities({ disableRange: false, isHttp: true, getResponseHeader: (headerName) => { if (headerName === 'Accept-Ranges') { return 'bytes'; } else if (headerName === 'Content-Encoding') { return null; } else if (headerName === 'Content-Length') { return 'eight'; } }, rangeChunkSize: 64, })).toEqual({ allowRangeRequests: false, suggestedLength: undefined, }); }); it('rejects file sizes that are too small for range requests', function() { expect(validateRangeRequestCapabilities({ disableRange: false, isHttp: true, getResponseHeader: (headerName) => { if (headerName === 'Accept-Ranges') { return 'bytes'; } else if (headerName === 'Content-Encoding') { return null; } else if (headerName === 'Content-Length') { return 8; } }, rangeChunkSize: 64, })).toEqual({ allowRangeRequests: false, suggestedLength: 8, }); }); it('accepts file sizes large enough for range requests', function() { expect(validateRangeRequestCapabilities({ disableRange: false, isHttp: true, getResponseHeader: (headerName) => { if (headerName === 'Accept-Ranges') { return 'bytes'; } else if (headerName === 'Content-Encoding') { return null; } else if (headerName === 'Content-Length') { return 8192; } }, rangeChunkSize: 64, })).toEqual({ allowRangeRequests: true, suggestedLength: 8192, }); }); }); describe('extractFilenameFromHeader', function() { it('returns null when content disposition header is blank', function() { expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return null; } })).toBeNull(); expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return undefined; } })).toBeNull(); expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return ''; } })).toBeNull(); }); it('gets the filename from the response header', function() { expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'inline'; } })).toBeNull(); expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'attachment'; } })).toBeNull(); expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'attachment; filename="filename.pdf"'; } })).toEqual('filename.pdf'); expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'attachment; filename="filename.pdf and spaces.pdf"'; } })).toEqual('filename.pdf and spaces.pdf'); expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'attachment; filename="tl;dr.pdf"'; } })).toEqual('tl;dr.pdf'); expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'attachment; filename=filename.pdf'; } })).toEqual('filename.pdf'); expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'attachment; filename=filename.pdf someotherparam'; } })).toEqual('filename.pdf'); }); it('gets the filename from the response header (RFC 6266)', function() { expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'attachment; filename*=filename.pdf'; } })).toEqual('filename.pdf'); expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'attachment; filename*=\'\'filename.pdf'; } })).toEqual('filename.pdf'); expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'attachment; filename*=utf-8\'\'filename.pdf'; } })).toEqual('filename.pdf'); expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'attachment; filename=no.pdf; filename*=utf-8\'\'filename.pdf'; } })).toEqual('filename.pdf'); expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'attachment; filename*=utf-8\'\'filename.pdf; filename=no.pdf'; } })).toEqual('filename.pdf'); }); it('gets the filename from the response header (RFC 2231)', function() { // Tests continuations (RFC 2231 section 3, via RFC 5987 section 3.1). expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'attachment; filename*0=filename; filename*1=.pdf'; } })).toEqual('filename.pdf'); }); it('only extracts filename with pdf extension', function () { expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'attachment; filename="filename.png"'; } })).toBeNull(); }); it('extension validation is case insensitive', function () { expect(extractFilenameFromHeader((headerName) => { if (headerName === 'Content-Disposition') { return 'form-data; name="fieldName"; filename="file.PdF"'; } })).toEqual('file.PdF'); }); }); describe('createResponseStatusError', function() { it('handles missing PDF file responses', function() { expect(createResponseStatusError(404, 'https://foo.com/bar.pdf')).toEqual( new MissingPDFException('Missing PDF "https://foo.com/bar.pdf".') ); expect(createResponseStatusError(0, 'file://foo.pdf')).toEqual( new MissingPDFException('Missing PDF "file://foo.pdf".') ); }); it('handles unexpected responses', function() { expect(createResponseStatusError(302, 'https://foo.com/bar.pdf')).toEqual( new UnexpectedResponseException( 'Unexpected server response (302) while retrieving PDF ' + '"https://foo.com/bar.pdf".' ) ); expect(createResponseStatusError(0, 'https://foo.com/bar.pdf')).toEqual( new UnexpectedResponseException( 'Unexpected server response (0) while retrieving PDF ' + '"https://foo.com/bar.pdf".' ) ); }); }); describe('validateResponseStatus', function() { it('accepts valid response statuses', function() { expect(validateResponseStatus(200)).toEqual(true); expect(validateResponseStatus(206)).toEqual(true); }); it('rejects invalid response statuses', function() { expect(validateResponseStatus(302)).toEqual(false); expect(validateResponseStatus(404)).toEqual(false); expect(validateResponseStatus(null)).toEqual(false); expect(validateResponseStatus(undefined)).toEqual(false); }); }); });