测试

有很多方法可以测试 React 应用程序。如果你想测试 React Flow 应用程序,我们建议使用 CypressPlaywright。React Flow 需要测量节点才能渲染边,为此依赖于渲染 DOM 元素。

使用 Cypress 或 Playwright

如果你使用的是 Cypress 或 Playwright,则无需进行任何额外设置。你可以参考 Cypress 入门指南Playwright 入门指南

使用 Jest

如果你使用的是 Jest,你需要模拟一些功能才能运行你的测试。你可以在你的项目中添加这个文件来实现。在 setupTests 文件(或在 beforeEach 内)中调用 mockReactFlow() 会触发必要的覆盖。

// To make sure that the tests are working, it's important that you are using
// this implementation of ResizeObserver and DOMMatrixReadOnly
class ResizeObserver {
  callback: globalThis.ResizeObserverCallback;
 
  constructor(callback: globalThis.ResizeObserverCallback) {
    this.callback = callback;
  }
 
  observe(target: Element) {
    this.callback([{ target } as globalThis.ResizeObserverEntry], this);
  }
 
  unobserve() {}
 
  disconnect() {}
}
 
class DOMMatrixReadOnly {
  m22: number;
  constructor(transform: string) {
    const scale = transform?.match(/scale\(([1-9.])\)/)?.[1];
    this.m22 = scale !== undefined ? +scale : 1;
  }
}
 
// Only run the shim once when requested
let init = false;
 
export const mockReactFlow = () => {
  if (init) return;
  init = true;
 
  global.ResizeObserver = ResizeObserver;
 
  // @ts-ignore
  global.DOMMatrixReadOnly = DOMMatrixReadOnly;
 
  Object.defineProperties(global.HTMLElement.prototype, {
    offsetHeight: {
      get() {
        return parseFloat(this.style.height) || 1;
      },
    },
    offsetWidth: {
      get() {
        return parseFloat(this.style.width) || 1;
      },
    },
  });
 
  (global.SVGElement as any).prototype.getBBox = () => ({
    x: 0,
    y: 0,
    width: 0,
    height: 0,
  });
};

如果你想用 Jest 测试鼠标事件(例如在你的自定义节点内),你需要禁用 d3-drag,因为它在浏览器外部无法正常工作。

<ReactFlow nodesDraggable={false} {...rest} />