What is "Script Error"?

Ben Vinegar

—March 3, 2021

The Problem

Click to Copy

Script error.

“Script error” is what browsers send to the onerror callback when an error originates from a JavaScript file served from a different origin (different domain, port, or protocol). It’s painful because even though there’s an error occurring, you don’t know what the error is, nor from which code it’s originating. And that’s the whole purpose of window.onerror – getting insight into uncaught errors in your application.

To better understand what’s going on, consider the following example HTML document, served at http://example.com/test:

Click to Copy

<!DOCTYPE html>
<html>
  <head>
    <title>example.com/test</title>
  </head>
  <body>
    <script src="http://another-domain.com/app.js"></script>
    <script>
      window.onerror = function(message, url, line, column, error) {
        console.log(message, url, line, column, error);
      };
      foo(); // call function declared in app.js
    </script>
  </body>
</html>

Here’s the contents of http://another-domain.com/app.js. It declares a single function, foo, whose invocation will always throw a ReferenceError.

Click to Copy

// another-domain.com/app.js
function foo() {
  bar(); // ReferenceError: bar is not a function
}

When this document is loaded in the browser and JavaScript is executed, the following is output to the console (logged via the window.onerror callback):

Click to Copy

"Script error.", "", 0, 0, undefined

This isn’t a bug – browsers intentionally hide errors originating from script files from different origins for security reasons. It’s to avoid a script unintentionally leaking potentially sensitive information to an onerror callback that it doesn’t control. For this reason, browsers only give window.onerror insight into errors originating from the same domain. All we know is that an error occurred – nothing else!

The Solution

In order to get visibility into errors thrown from scripts originating from different origins, you must do two things.

Cross Origin Anonymous

Click to Copy

<script src="http://another-domain.com/app.js" crossorigin="anonymous"></script>

This tells the browser that the target file should be fetched “anonymously”. This means that no potentially user-identifying information like cookies or HTTP credentials will be transmitted by the browser to the server when requesting this file.

Cross Origin HTTP header

Click to Copy

Access-Control-Allow-Origin: *

CORS is short for “Cross Origin Resource Sharing”, and it’s a set of APIs (mostly HTTP headers) that dictate how files ought to be downloaded and served across origins. By setting “Access-Control-Allow-Origin: *”, the server is indicating to browsers that any origin can fetch this file.

By setting the global wildcard, you are indicating that any origin can consume this server. If you want, you can restrict it to only known domains you control, e.g.

Click to Copy

Access-Control-Allow-Origin: http://www.example.com, http://www.another-domain.com

Note: Most community CDNs properly set an Access-Control-Allow-Origin header.

Once both of these steps have been made, any errors triggered by this script will report to window.onerror just like any regular same-domain script. So instead of “Script error”, the onerror example from the beginning will yield:

Click to Copy

ReferenceError: bar is not defined", "http://another-domain.com/app.js", 2, 1, [Object Error]

Platform

Languages & Frameworks

Why Sentry?

What is "Script Error"?

The Problem

The Solution

Cross Origin Anonymous

Cross Origin HTTP header

Further Reading

What is "Script Error"?

The Solution

Cross Origin Anonymous

Cross Origin HTTP header

Further Reading

A peek at your privacy

Who we collect PII from

PII we may collect about you

How we use your PII

Third parties who receive your PII

We use cookies (but not for advertising)

Know your rights