PromucFlow_constructor/app/client/src/utils/MessageUtil.ts

49 lines
1.3 KiB
TypeScript
Raw Normal View History

/**
* This file contains the utility function to send and receive messages from the worker.
* TRequestMessage<TBody> is used to send a request to/from the worker.
* TResponseMessage<TBody> is used to send a response to/from the worker.
* TDefaultMessage<TBody> is used to send a message to/from worker. Does not expect a response.
*/
export enum MessageType {
REQUEST = "REQUEST",
RESPONSE = "RESPONSE",
DEFAULT = "DEFAULT",
}
interface TRequestMessage<TBody> {
body: TBody;
messageId: string;
messageType: MessageType.REQUEST;
}
interface TResponseMessage<TBody> {
body: TBody;
messageId: string;
messageType: MessageType.RESPONSE;
}
export interface TDefaultMessage<TBody> {
fix: access outer scope variables inside callbacks (#20168) ## Description Any platform function that accepts a callback were unable to access the variables declared in its parent scopes. This was a implementation miss when we originally designed platform functions and again when we turned almost every platform function into a Promise. This PR fixes this limitation along with some other edge cases. - Access outer scope variables inside the callback of run, postMessage, setInterval, getGeoLocation and watchGeolocation functions. - Fixes certain edge cases where functions with callbacks when called inside the then block doesn't get executed. Eg `showAlert.then(() => /* Doesn't execute */ Api1.run(() => {}))` - Changes the implementation of all the platform function in appsmith to maintain the execution metadata (info on from where a function was invoked, event associated with it etc) #### Refactor changes - Added a new folder **_fns_** that would now hold all the platform functions. - Introduced a new ExecutionMetadata singleton class that is now responsible for hold all the meta data related to the current evaluation. - Remove TRIGGER_COLLECTOR array where all callback based platform functions were batched and introduced an Event Emitter based implementation to handle batched fn calls. - All callback based functions now emits event when invoked. These events have handlers attached to the TriggerEmitter object. These handler does the job of batching these invocations and telling the main thread. It also ensures that platform fn calls that gets triggered out the the context of a request/response cycle work. #### Architecture <img width="751" alt="Screenshot 2023-02-07 at 10 04 26" src="https://user-images.githubusercontent.com/32433245/217259200-5eac71bc-f0d3-4d3c-9b69-2a8dc81351bc.png"> Fixes #13156 Fixes #20225 ## Type of change - Bug fix (non-breaking change which fixes an issue) - Refactor ## How Has This Been Tested? - Jest - Cypress - Manual ### Test Plan - [ ] https://github.com/appsmithorg/TestSmith/issues/2181 - [ ] https://github.com/appsmithorg/TestSmith/issues/2182 - [ ] Post message - https://appsmith-git-chore-outer-scope-variable-access-get-appsmith.vercel.app/app/post-msg-app/page1-635fcfba2987b442a739b938/edit - [ ] Apps: https://appsmith-git-chore-outer-scope-variable-access-get-appsmith.vercel.app/app/earworm-1/home-630c9d85b4658d0f257c4987/edit - [ ] https://appsmith-git-chore-outer-scope-variable-access-get-appsmith.vercel.app/app/automation-test-cases/page-1-630c6b90d4ecd573f6bb01e9/edit#0hmn8m90ei ### Issues raised during DP testing > Link issues raised during DP testing for better visiblity and tracking (copy link from comments dropped on this PR) ## Checklist: ### Dev activity - [x] My code follows the style guidelines of this project - [x] I have performed a self-review of my own code - [x] I have commented my code, particularly in hard-to-understand areas - [x] I have made corresponding changes to the documentation - [x] My changes generate no new warnings - [x] I have added tests that prove my fix is effective or that my feature works - [x] New and existing unit tests pass locally with my changes - [ ] PR is being merged under a feature flag ### QA activity: - [ ] Test plan has been approved by relevant developers - [ ] Test plan has been peer reviewed by QA - [ ] Cypress test cases have been added and approved by either SDET or manual QA - [ ] Organized project review call with relevant stakeholders after Round 1/2 of QA - [ ] Added Test Plan Approved label after reviewing all Cypress test
2023-02-11 18:33:20 +00:00
messageId?: string;
body: TBody;
messageType: MessageType.DEFAULT;
}
export type TMessage<TBody> =
| TRequestMessage<TBody>
| TResponseMessage<TBody>
| TDefaultMessage<TBody>;
/** Avoid from using postMessage directly.
* This function should be used to send messages to the worker and back.
* Purpose: To have some standardization in the messages that are transferred.
* TODO: Add support for window postMessage options
* TODO: Add support for transferable objects.
*/
export function sendMessage(
this: Worker | typeof globalThis,
message: TMessage<unknown>,
) {
this.postMessage(message);
}