Integration tests for individual repositores

[juliusknorr]

We had discussions how we can run integration tests for the individual repositories. The primary goal would be to catch failures that impact breaking the document server early with some basic some testing.

Some rough outline of my idea:

• We pull the pre-built document server image
• For each repository we build the relevant parts and copy over the build assets to the existing image
• We run the document server and run some e2e/smoke test cases against it
• Ideally we use the example app that is shipped or we connect to a Nextcloud instance
• Tests could be done with playwright to cover some basics for opening files, doing a few edits and saving

#1
Euro-Office/web-apps#33

[juliusknorr]

Some ideas for asserting documents and learning about the document api:

Asserting document content via JS APIs

All three editors expose a JS API inside the frameEditor iframe that can be called from frame.evaluate() in Playwright tests.

Waiting for the editor to be ready

Each editor sets window.editor_elements_prepared = true once the SDK has fully loaded. Poll this before calling any API:

const frame = editorPage.frames().find(f => f.name() === 'frameEditor')!;

await frame.waitForFunction(
  () => window['editor_elements_prepared'] === true,
  { timeout: 30_000 },
);

Document name (all editor types)

const name = await frame.evaluate(() => window['Asc'].editor.asc_getDocumentName());
// e.g. "new.docx", "new.xlsx", "new.pptx"

Word — get all text

Asc.editor.getJsApi() returns AscBuilder.Word.Api, the same API used by macros:

const text = await frame.evaluate(() => {
  const Api = window['Asc'].editor.getJsApi();
  return Api.GetDocument().GetText();
});
expect(text).toContain('Expected content');

Spreadsheet — read a cell value

Asc.editor.getJsApi() returns AscBuilder.Cell.Api:

const value = await frame.evaluate(() => {
  const Api = window['Asc'].editor.getJsApi();
  return Api.GetActiveSheet().GetRange('A1').GetValue();
});
expect(value).toBe('Expected value');

This works because the iframe and the parent page share the same origin. frame.evaluate() respects same-origin policy and does not bypass it.