Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore(deps): upgrades jest to 28 #4783

Merged
merged 18 commits into from May 17, 2022
Merged

Conversation

dimitropoulos
Copy link
Contributor

@dimitropoulos dimitropoulos commented May 13, 2022

In lieu of the normal description, I have written a bunch of comments on specific topics that came up during this work. The one and only goal of this PR is to upgrade jest with the smallest footprint possible. If you have any ideas on how to further reduce the footprint, lemme know!

@@ -1,3 +1,5 @@
import { describe, expect, it } from '@jest/globals';
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

after this PR, we can go ahead and add this to every test file in the project, which will allow us to no longer depend on the globals and also will mean that TypeScript will correctly tell us we cannot use jest stuff from our source code (by accident, for example).

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok I see. I actually like the clarity. Thank you for doing this work.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

for anyone interested to learn more about @jest/globals DefinitelyTyped/DefinitelyTyped#44365 is a decent primer. the TLDR; is that it allows us to use jest without globals (which, for us, means that we can't then accidentally call jest globals from our non-test source code).

@@ -3,7 +3,7 @@ module.exports = {
collectCoverage: false,
globals: {
'ts-jest': {
isolatedModules: true,
isolatedModules: false,
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it's time for this default to flip. it means our tests will be typechecked by default (which, then means we'll have to turn it off in those that have errors rather than turn it on in those that don't, and new packages will have it by default).

import { ByRoleMatcher, ByRoleOptions, fireEvent, render } from '@testing-library/react';
import React from 'react';

import { Tooltip } from './tooltip';

const pause = (time: number) => new Promise(resolve => setTimeout(resolve, time));

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this test was actually pausing in real wall-clock time before. now.. it doesn't.

@@ -13,7 +13,6 @@
"node_modules",
"dist",
"src/jest",
".babelrc.js",
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this file was deleted a while back and it looks like we just missed deleting it here.

@@ -1,15 +0,0 @@
/** @type { import('@babel/core').TransformOptions } */
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is unused insofar as I can tell. I thought maybe jest uses it, but I tested that and it appears it does not.

@@ -1,29 +1,20 @@
/** @type { import('@jest/types').Config.InitialOptions } */
module.exports = {
// preset: '../../jest-preset.js', // DOES NOT WORK
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I figured out why this doesn't work see jestjs/jest#12817 for what the solution was

'styled-components': '<rootDir>/../node_modules/styled-components',
'\\.(css|less|png)$': '<rootDir>/src/__mocks__/dummy.ts',
'styled-components': '<rootDir>/node_modules/styled-components',
'jsonpath-plus': '<rootDir>/node_modules/jsonpath-plus/dist/index-node-cjs.cjs',
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it may not seem like much, but this line of code took me about 5 hours, maybe more, to arrive at. there's some funky business for jsonpath-plus that we have to work around and it was quite a bear.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Related reference: https://nodejs.org/api/packages.html#conditional-exports
Scoped out of this PR are changes to testEnvironment: jsdom
Which resolves "browser" modules by default, rather than the commonjs "node" modules which would be resolved in electron context currently. Also related to electron api "contextIsolation"

const resultDecrypted = crypt.decryptAESToBuffer(key, resultEncrypted);
expect(resultDecrypted).toEqual(Buffer.from('Hello World!', 'utf8'));
expect(resultDecrypted.toString()).toEqual(source.toString());
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it's non-ideal to have to toString these before comparison, but if we don't the match fails because one buffer comes from the npm and one comes from node. and if we try to flip that around we get stuck because we can't polyfill what's in the hkdf npm (which doesn't use the buffer npm, and uses the global).

expect(setTimeout).toHaveBeenCalledTimes(3);
expect(setTimeout).nthCalledWith(1, expect.anything(), 100);
expect(setTimeout).nthCalledWith(2, expect.anything(), 100);
expect(setTimeout).nthCalledWith(3, expect.anything(), 100);
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

for these kinds of things it was tricky and everyone on the team agreed that asserting on the result is plenty verification. we don't need to mock and assert on the internals (e.g. setInterval). I still wish I understood why it didn't work, but so it goes.

@@ -1,4 +1,4 @@
import { mocked } from 'ts-jest/utils';
import { mocked } from 'jest-mock';
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@@ -348,7 +342,9 @@ export const database = {
config,
),
);
collection.persistence.setAutocompactionInterval(DB_PERSIST_INTERVAL);
if (!config.inMemoryOnly) {
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this should be an effective noop in runtime and has the benefit of helping out the tests

Copy link
Contributor

@marckong marckong left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. We've paired on the Zoom with the team, so I've seen this works like a charm! I am just wondering if console log and experiment.test were intended to be included.

@dimitropoulos
Copy link
Contributor Author

@marckong see #4783 (comment). I was doing a self review (actually I went through the PR 3 separate times top-to-bottom and found things each time. The signal that it's ready to review would be pulling it out of draft and assigning reviewers, which I will do immediately after typing this message. :)

@dimitropoulos dimitropoulos marked this pull request as ready for review May 13, 2022 17:10
@marckong
Copy link
Contributor

Yeah I didn't realize this was the draft lol I automatically jumped onto it because it reminded me of the zoom call excitement! Amazing work!

Copy link
Member

@filfreire filfreire left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tested it locally for a while, LGTM 👍

Copy link
Contributor

@jackkav jackkav left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • 25k package lock, very nice.
    isolatedModules might be something we come back to later, hopefully no sharp edges. 🤞

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants