forms

import { forms } from "@spoar/sdk/plugins";

import { createAnalytics } from "@spoar/sdk";
import { forms } from "@spoar/sdk/plugins";

export const analytics = createAnalytics({
  project: "example.com",
  key: "pk_...",
  endpoint: "/_ra",
  plugins: [forms()],
});

OptionsCopy Anchor Link

forms() takes no options.

SendsCopy Anchor Link

• form is the form's id, else its name attribute, else an empty string.
• action is the path of the form's action URL, or of the current page when the form has none. The host and query string are left out.

BehaviourCopy Anchor Link

• One submit listener on document, in the capture phase, so every form on the page counts, including forms added later.
• Nothing from the fields is read: no values, names or counts.
• The event is sent when the browser fires submit, whether or not your own handler then cancels it or the request fails. A form the browser's built-in validation blocks fires no submit and sends nothing.

In reportsCopy Anchor Link

breakdown/prop:form with filter[event]=form_submit counts submissions per form.