jsdoc and fix cleanup of _pageloadSpan

Author: Lms24

packages/browser/src/tracing/browserTracingIntegration.ts

@@ -437,6 +437,11 @@ export const browserTracingIntegration = ((options: Partial<BrowserTracingOption
           sampled: spanIsSampled(idleSpan),
           dsc: getDynamicSamplingContextFromSpan(span),
         });
+
+        if (isPageloadSpan) {
+          // clean up the stored pageload span on the intergration.
+          _pageloadSpan = undefined;
+        }
       },
       trimIdleSpanEndTimestamp: !explicitPageloadEnd,
     });
@@ -606,7 +611,6 @@ export const browserTracingIntegration = ((options: Partial<BrowserTracingOption
         if (explicitPageloadEnd && _pageloadSpan) {
           _pageloadSpan.setAttribute(SEMANTIC_ATTRIBUTE_SENTRY_IDLE_SPAN_FINISH_REASON, 'reportPageLoaded');
           _pageloadSpan.end();
-          _pageloadSpan = undefined;
         }
       });
     },

packages/core/src/client.ts

@@ -606,6 +606,10 @@ export abstract class Client<O extends ClientOptions = ClientOptions> {
     ) => void,
   ): () => void;
 
+  /**
+   * A hook for the browser tracing integrations to trigger the end of a page load span.
+   * @returns {() => void} A function that, when executed, removes the registered callback.
+   */
   public on(hook: 'endPageloadSpan', callback: () => void): () => void;
 
   /**