koa-lite/test/response/attachment.js

186 lines
6.7 KiB
JavaScript
Raw Normal View History

'use strict';
2017-05-11 03:30:32 +00:00
const assert = require('assert');
const context = require('../helpers/context');
const request = require('supertest');
2015-10-13 06:19:42 +00:00
const Koa = require('../..');
describe('ctx.attachment([filename])', () => {
describe('when given a filename', () => {
it('should set the filename param', () => {
const ctx = context();
ctx.attachment('path/to/tobi.png');
const str = 'attachment; filename="tobi.png"';
2017-05-11 03:30:32 +00:00
assert.equal(ctx.response.header['content-disposition'], str);
2015-10-12 20:36:41 +00:00
});
});
describe('when omitting filename', () => {
it('should not set filename param', () => {
const ctx = context();
ctx.attachment();
2017-05-11 03:30:32 +00:00
assert.equal(ctx.response.header['content-disposition'], 'attachment');
2015-10-12 20:36:41 +00:00
});
});
describe('when given a no-ascii filename', () => {
it('should set the encodeURI filename param', () => {
const ctx = context();
ctx.attachment('path/to/include-no-ascii-char-中文名-ok.png');
const str = 'attachment; filename="include-no-ascii-char-???-ok.png"; filename*=UTF-8\'\'include-no-ascii-char-%E4%B8%AD%E6%96%87%E5%90%8D-ok.png';
2017-05-11 03:30:32 +00:00
assert.equal(ctx.response.header['content-disposition'], str);
2015-10-12 20:36:41 +00:00
});
2017-05-11 03:30:32 +00:00
it('should work with http client', () => {
2015-10-13 06:19:42 +00:00
const app = new Koa();
app.use((ctx, next) => {
ctx.attachment('path/to/include-no-ascii-char-中文名-ok.json');
ctx.body = {foo: 'bar'};
2015-10-12 20:36:41 +00:00
});
return request(app.callback())
.get('/')
.expect('content-disposition', 'attachment; filename="include-no-ascii-char-???-ok.json"; filename*=UTF-8\'\'include-no-ascii-char-%E4%B8%AD%E6%96%87%E5%90%8D-ok.json')
.expect({foo: 'bar'})
2017-05-11 03:30:32 +00:00
.expect(200);
2015-10-12 20:36:41 +00:00
});
});
});
// reference test case of content-disposition module
describe('contentDisposition(filename, options)', () => {
describe('with "fallback" option', () => {
it('should require a string or Boolean', () => {
const ctx = context();
assert.throws(() => { ctx.attachment('plans.pdf', { fallback: 42 }); },
/fallback.*string/);
});
it('should default to true', () => {
const ctx = context();
ctx.attachment('€ rates.pdf');
assert.equal(ctx.response.header['content-disposition'],
'attachment; filename="? rates.pdf"; filename*=UTF-8\'\'%E2%82%AC%20rates.pdf');
});
describe('when "false"', () => {
it('should not generate ISO-8859-1 fallback', () => {
const ctx = context();
ctx.attachment('£ and € rates.pdf', { fallback: false });
assert.equal(ctx.response.header['content-disposition'],
'attachment; filename*=UTF-8\'\'%C2%A3%20and%20%E2%82%AC%20rates.pdf');
});
it('should keep ISO-8859-1 filename', () => {
const ctx = context();
ctx.attachment('£ rates.pdf', { fallback: false });
assert.equal(ctx.response.header['content-disposition'],
'attachment; filename="£ rates.pdf"');
});
});
describe('when "true"', () => {
it('should generate ISO-8859-1 fallback', () => {
const ctx = context();
ctx.attachment('£ and € rates.pdf', { fallback: true });
assert.equal(ctx.response.header['content-disposition'],
'attachment; filename="£ and ? rates.pdf"; filename*=UTF-8\'\'%C2%A3%20and%20%E2%82%AC%20rates.pdf');
});
it('should pass through ISO-8859-1 filename', () => {
const ctx = context();
ctx.attachment('£ rates.pdf', { fallback: true });
assert.equal(ctx.response.header['content-disposition'],
'attachment; filename="£ rates.pdf"');
});
});
describe('when a string', () => {
it('should require an ISO-8859-1 string', () => {
const ctx = context();
assert.throws(() => { ctx.attachment('€ rates.pdf', { fallback: '€ rates.pdf' }); },
/fallback.*iso-8859-1/i);
});
it('should use as ISO-8859-1 fallback', () => {
const ctx = context();
ctx.attachment('£ and € rates.pdf', { fallback: '£ and EURO rates.pdf' });
assert.equal(ctx.response.header['content-disposition'],
'attachment; filename="£ and EURO rates.pdf"; filename*=UTF-8\'\'%C2%A3%20and%20%E2%82%AC%20rates.pdf');
});
it('should use as fallback even when filename is ISO-8859-1', () => {
const ctx = context();
ctx.attachment('"£ rates".pdf', { fallback: '£ rates.pdf' });
assert.equal(ctx.response.header['content-disposition'],
'attachment; filename="£ rates.pdf"; filename*=UTF-8\'\'%22%C2%A3%20rates%22.pdf');
});
it('should do nothing if equal to filename', () => {
const ctx = context();
ctx.attachment('plans.pdf', { fallback: 'plans.pdf' });
assert.equal(ctx.response.header['content-disposition'],
'attachment; filename="plans.pdf"');
});
it('should use the basename of the string', () => {
const ctx = context();
ctx.attachment('€ rates.pdf', { fallback: '/path/to/EURO rates.pdf' });
assert.equal(ctx.response.header['content-disposition'],
'attachment; filename="EURO rates.pdf"; filename*=UTF-8\'\'%E2%82%AC%20rates.pdf');
});
it('should do nothing without filename option', () => {
const ctx = context();
ctx.attachment(undefined, { fallback: 'plans.pdf' });
assert.equal(ctx.response.header['content-disposition'],
'attachment');
});
});
});
describe('with "type" option', () => {
it('should default to attachment', () => {
const ctx = context();
ctx.attachment();
assert.equal(ctx.response.header['content-disposition'],
'attachment');
});
it('should require a string', () => {
const ctx = context();
assert.throws(() => { ctx.attachment(undefined, { type: 42 }); },
/invalid type/);
});
it('should require a valid type', () => {
const ctx = context();
assert.throws(() => { ctx.attachment(undefined, { type: 'invlaid;type' }); },
/invalid type/);
});
it('should create a header with inline type', () => {
const ctx = context();
ctx.attachment(undefined, { type: 'inline' });
assert.equal(ctx.response.header['content-disposition'],
'inline');
});
it('should create a header with inline type & filename', () => {
const ctx = context();
ctx.attachment('plans.pdf', { type: 'inline' });
assert.equal(ctx.response.header['content-disposition'],
'inline; filename="plans.pdf"');
});
it('should normalize type', () => {
const ctx = context();
ctx.attachment(undefined, { type: 'INLINE' });
assert.equal(ctx.response.header['content-disposition'],
'inline');
});
});
});