Share
Embed
TypeScriptとJestではじめる AWS製サーバーレス REST API のユニットテスト・E2Eテスト #serverlessfukuoka #serverlessdays / Serverless testing using TypeScript and Jest
この発表では、サーバーレスアプリケーションのユニットテストとE2Eテストを書くときの考え方とその手段について述べます。テストについて議論するときは、アプリケーション設計についても述べなければなりません。
発表の中でまず、サーバーレスアプリケーションは、レイヤ・機能別にコードを分類できることを示します。その後、分類しおたコードに対し、Jestでモック化し、テスト対象を抽出してテストするユニットテストを行います。このときモック対象の戦略についても話します。
最後にE2Eテストの有効性と実行方法を述べます。
Yusuke Wada
December 14, 2019
Transcript
58 slides
-
େࠓࢀߟʹ͍͍ͤͯͨͩͨ͞ใ ాਓ, 2017/6/2 AWS Dev Day Tokyo 2017 IUUQTTQFBLFSEFDLDPNUXBEBUFTUBCMFMBNCEBXPSLJOHF⒎FDUJWFMZXJUIMFHBDZMBNCEB Testable
Lambda Working Effectivery with Legacy Lambda Clean Architecture ୡਓʹֶͿιϑτΣΞͷ ߏͱઃܭ Robert C. Martin ςετۦಈ։ൃ Kent Beck, ాਓ -
5JQTϞοΫԽʹ+FTUͷTQZ0O ཱ͕ͭ describe('Clear ticket use case', () => { test('run
clear ticket', async (): Promise<void> => { const en = ExchangeNotification.of('123456'); const getTicketSpy = jest .spyOn(ticket, 'getTicket') .mockResolvedValue(searchTicket); const clearTicketSpy = jest .spyOn(ticket, 'clearTicket') .mockResolvedValue('Created:UT'); const result = await clearingTicketUseCase(en); expect(result).toEqual({ result: 'Created', }); expect(getTicketSpy).toHaveBeenCalledWith( en.ticketNo,en.shoriTime, ); expect(clearTicketSpy).toHaveBeenCalledWith(searchTicket); }); }); -
5JQTϞοΫԽʹ+FTUͷTQZ0O ཱ͕ͭ describe('Clear ticket use case', () => { test('run
clear ticket', async (): Promise<void> => { const en = ExchangeNotification.of('123456'); const getTicketSpy = jest .spyOn(ticket, 'getTicket') .mockResolvedValue(searchTicket); const clearTicketSpy = jest .spyOn(ticket, 'clearTicket') .mockResolvedValue('Created:UT'); const result = await clearingTicketUseCase(en); expect(result).toEqual({ result: 'Created', }); expect(getTicketSpy).toHaveBeenCalledWith( en.ticketNo,en.shoriTime, ); expect(clearTicketSpy).toHaveBeenCalledWith(searchTicket); }); }); ͜ΕͰϩʔΧϧ࣮ߦՄೳ -
5JQTϐϡΞϩδοΫͷཏʹ1BSBNFUFSJ[FE describe('NotNullValidator', () => { test.each` name | value |
expected ${'address'} | ${'tokyo'} | ${{ isValid: true }} ${'first name'} | ${''} | ${{ isValid: true }} ${'first name'} | ${null} | ${{ isValid: false }} `( 'input $value, validation result expected: $expected.isValid', ({ name, value, expected }) => { const suc = new NotNullValidator(name, value); expect(suc.validate()).toEqual({ isValid: expected.isValid, }); }, ); }); -
5JQTϐϡΞϩδοΫͷཏʹ1BSBNFUFSJ[FE describe('NotNullValidator', () => { test.each` name | value |
expected ${'address'} | ${'tokyo'} | ${{ isValid: true }} ${'first name'} | ${''} | ${{ isValid: true }} ${'first name'} | ${null} | ${{ isValid: false }} `( 'input $value, validation result expected: $expected.isValid', ({ name, value, expected }) => { const suc = new NotNullValidator(name, value); expect(suc.validate()).toEqual({ isValid: expected.isValid, }); }, ); }); ೖྗɾظϖΞΛςʔϒϧܗࣜͰఆٛ -
8FC"1*ࣄͷύλʔϯ ϦΫΤετϨεϙϯε describe('exchange API', (): void => { test('clear ticket',
async (): void => { const exchangeNotificationUrl = 'http://ticket-system.jp/ticket/clear'; const request = { shori_id: '01234567890', }; const response = await Axios.post( exchangeNotificationUrl, qs.stringify(request), ); expect(response.data).toEqual('{ "response": "ok" }'); }); }); -
8FC"1*ࣄͷύλʔϯ ϦΫΤετϨεϙϯε describe('exchange API', (): void => { test('clear ticket',
async (): void => { const exchangeNotificationUrl = 'http://ticket-system.jp/ticket/clear'; const request = { shori_id: '01234567890', }; const response = await Axios.post( exchangeNotificationUrl, qs.stringify(request), ); expect(response.data).toEqual('{ "response": "ok" }'); }); }); ϨεϙϯεϘσΟΛ֬ೝ -
8FC"1*ࣄͷύλʔϯ ϦΫΤετσʔλอଘ describe('exchange API', (): void => { test('clear ticket',
async (): void => { // Axios request … // const param = { TableName: 'ticket-info', Key: { shoriId: '01234567890' }, }; const dynamoData = await dynamo.getItem(param).promsie(); expect(dynamoData).toEqual({ shoriId: request.shori_id, clear: true, }); }); }); -
8FC"1*ࣄͷύλʔϯ ϦΫΤετσʔλอଘ describe('exchange API', (): void => { test('clear ticket',
async (): void => { // Axios request … // const param = { TableName: 'ticket-info', Key: { shoriId: '01234567890' }, }; const dynamoData = await dynamo.getItem(param).promsie(); expect(dynamoData).toEqual({ shoriId: request.shori_id, clear: true, }); }); }); อଘ͞ΕͨσʔλΛ֬ೝ -
ྫɿ4ʹอଘͨ͠ॲཧهΛࢀরͯ֬͠ೝ͢Δ describe('exchange API', (): void => { test('clear ticket', async
(): Promise<void> => { const exchangeNotificationUrl = 'http://ticket-system.jp/ticket/clear'; const request = { shori_id: '01234567890', }; const response = await Axios.post( exchangeNotificationUrl, qs.stringify(request), ); expect(response.data).toEqual('{ "response": "ok" }'); const param = { Bucket: 'ticket-info', Key: request.shori_id, }; const s3Obj = await s3.getObject(param).promsie(); const reocrd = JSON.parse(s3Obj.Body!.toString()); expect(reocrd).toEqual({ monitor: 'Created', }); }); }); -
ྫɿ4ʹอଘͨ͠ॲཧهΛࢀরͯ֬͠ೝ͢Δ describe('exchange API', (): void => { test('clear ticket', async
(): Promise<void> => { const exchangeNotificationUrl = 'http://ticket-system.jp/ticket/clear'; const request = { shori_id: '01234567890', }; const response = await Axios.post( exchangeNotificationUrl, qs.stringify(request), ); expect(response.data).toEqual('{ "response": "ok" }'); const param = { Bucket: 'ticket-info', Key: request.shori_id, }; const s3Obj = await s3.getObject(param).promsie(); const reocrd = JSON.parse(s3Obj.Body!.toString()); expect(reocrd).toEqual({ monitor: 'Created', }); }); }); -
ྫɿ4ʹอଘͨ͠ॲཧهΛࢀরͯ֬͠ೝ͢Δ describe('exchange API', (): void => { test('clear ticket', async
(): Promise<void> => { const exchangeNotificationUrl = 'http://ticket-system.jp/ticket/clear'; const request = { shori_id: '01234567890', }; const response = await Axios.post( exchangeNotificationUrl, qs.stringify(request), ); expect(response.data).toEqual('{ "response": "ok" }'); const param = { Bucket: 'ticket-info', Key: request.shori_id, }; const s3Obj = await s3.getObject(param).promsie(); const reocrd = JSON.parse(s3Obj.Body!.toString()); expect(reocrd).toEqual({ monitor: 'Created', }); }); }); ֎෦"1*͔Β$SFBUFE͕ ฦ͖ͬͯͨ͜ͱΛهɺ֬ೝ ※࣮ࡍʹԆͱϦτϥΠ͕ඞཁ -
ϢχοτςετҎ߱ͷΤϥʔϓϧʔϑΟϯά )VNCMF0CKFDU ͷϢχοτςετ ϐϡΞϩδοΫͷϢχοτςετ ਖ਼ৗܥͷ&&ςετ ҟৗܥΛؚΉ&&ςετ 6 5 &
& JSONมϛε ϩδοΫߟྀ࿙Ε AWSߏϛε IAMϛε ༷ͷෆ۩߹ -
ϢχοτςετͷΞϓϩʔν )VNCMF0CKFDU ͷϢχοτςετ ϐϡΞϩδοΫͷϢχοτςετ ਖ਼ৗܥͷ&&ςετ ҟৗܥΛؚΉ&&ςετ 6 5 &
& JSONมϛε ϩδοΫߟྀ࿙Ε AWSߏϛε IAMϛε ༷ͷෆ۩߹ ςετ͍͢͠ϐϡΞϩδοΫͱͦΕҎ֎Λׂͨ͠ -
ϢχοτςετͷΞϓϩʔν )VNCMF0CKFDU ͷϢχοτςετ ϐϡΞϩδοΫͷϢχοτςετ ਖ਼ৗܥͷ&&ςετ ҟৗܥΛؚΉ&&ςετ 6 5 &
& JSONมϛε ϩδοΫߟྀ࿙Ε AWSߏϛε IAMϛε ༷ͷෆ۩߹ +FTUͷػೳΛ׆༻ͯ͠ޮԽͰ͖Δ ɾspyOn() ʹΑΔϞοΫ ɾparameterized test -
&&ςετ )VNCMF0CKFDU ͷϢχοτςετ ϐϡΞϩδοΫͷϢχοτςετ ਖ਼ৗܥͷ&&ςετ ҟৗܥΛؚΉ&&ςετ 6 5 &
& JSONมϛε ϩδοΫߟྀ࿙Ε AWSߏϛε IAMϛε ༷ͷෆ۩߹ ·ͣҰຊ௨͢ -
&&ςετ )VNCMF0CKFDU ͷϢχοτςετ ϐϡΞϩδοΫͷϢχοτςετ ਖ਼ৗܥͷ&&ςετ ҟৗܥΛؚΉ&&ςετ 6 5 &
& JSONมϛε ϩδοΫߟྀ࿙Ε AWSߏϛε IAMϛε ༷ͷෆ۩߹ ύλʔϯʹ߹Θ࣮ͤͯࢪ ɾϦΫΤετ-Ϩεϙϯε ɾϦΫΤετ-σʔλอଘ ɾϦΫΤετ-αʔϏείʔϧ -
·ͱΊ )VNCMF0CKFDU ͷϢχοτςετ ϐϡΞϩδοΫͷϢχοτςετ ਖ਼ৗܥͷ&&ςετ ҟৗܥΛؚΉ&&ςετ 6 5 &
& JSONมϛε ϩδοΫߟྀ࿙Ε AWSߏϛε IAMϛε ༷ͷෆ۩߹ ͜ͷ;ͨͭɺίεύ˕Ͱ͡Ί͍͢ʂ˞ͪΖΜ࠷ޙશ෦Δ -
େࠓࢀߟʹ͍͍ͤͯͨͩͨ͞ใ ాਓ, 2017/6/2 AWS Dev Day Tokyo 2017 IUUQTTQFBLFSEFDLDPNUXBEBUFTUBCMFMBNCEBXPSLJOHF⒎FDUJWFMZXJUIMFHBDZMBNCEB Testable
Lambda Working Effectivery with Legacy Lambda Clean Architecture ୡਓʹֶͿιϑτΣΞͷ ߏͱઃܭ Robert C. Martin ςετۦಈ։ൃ Kent Beck, ాਓ