← All questions

When should I reach for the mock step instead of @har, or the other way round?

When I mock "**/api/banner" with JSON:
  """json
  { "text": "Welcome {{username}}" }
  """

3 answers

• 22votes

  Not taste. They answer different questions.

  • The mock step is route fulfilment for one URL pattern with a payload you wrote. Use it when the payload is the point of the test: an empty list, a 500, a banner with a specific string in it. The response is authored, so it says exactly what you meant.
  • @har:<name> is a snapshot of whatever the application actually sent, every request in the scenario, captured once and replayed verbatim. Use it when the payload is not the point and you just want the scenario to stop depending on a live service.

  Rough test: if you would have to hand-write more than one or two responses to make the page render, record a HAR. If you are asserting on a value you chose, mock it inline, because a recording will drift away from your assertion the next time someone re-records it.

  JOanswered by Jide Okonkwo11,745 · 3 Oct 2022
• 9votes

  We ended up using both in the same scenario and it works fine. Record the background traffic so the page loads offline, then mock the one endpoint whose shape the test is about. No trouble so far — the mock wins for its pattern and the recording answers everything else.

  One thing to watch: tag the scenario @mock as well if it carries an inline mock, otherwise nobody grepping for stubbed scenarios will find it.

  GCanswered by Gio Castellano521 · 6 Oct 2022
• 14votes

  One more axis nobody has mentioned: layers.

  The mock step is a browser step. It fulfils a page route, so it does nothing for an @api scenario. The @har:<name> tag drives both layers from the same tag — the browser side through Playwright route interception, the API side through the API client’s own recorder and replayer.

  So for an @api or @hybrid scenario that needs stubbed traffic, HAR is not one of two options, it is the option.

  Network mocking and HAR

  RNanswered by Reeta Nandalmaintainer41,280 · 2 Nov 2022