Tüm Ürünler
Search
Belge Merkezi

Application Real-Time Monitoring Service:Komut dosyası hatalarının nedenleri ve çözümleri

Son Güncelleme:Oct 05, 2026

Komut dosyası hataları sık karşılaşılan hata türlerindendir. Ancak bu tür hatalar için eksiksiz bir hata iletisi veya hata yığını mevcut değildir. Bu nedenle söz konusu hataları gidermek zordur. Bu konuda komut dosyası hatalarının nedenlerini inceliyor, çözümler sunuyor ve Application Real-Time Monitoring Service (ARMS) içinde bu tür hataların nasıl yok sayılacağını gösteriyoruz.

Komut dosyası hatalarının nedenleri

Komut dosyası hataları kökenler arası hatalar olarak da adlandırılır. Bir web sitesi üçüncü taraf bir alan adı altında barındırılan bir komut dosyasını istediğinde ve çalıştırdığında komut dosyası hatası oluşabilir. En yaygın senaryo, JavaScript (JS) kaynaklarını bir content delivery network (CDN) üzerinde barındırmaktır.

Konunun daha iyi anlaşılması için aşağıdaki HTML sayfasının http://test.com alan adına dağıtıldığını varsayalım:

<!doctype html>
<html>
<head>
  <title>Test page in http://test.com</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(); // Invokes the foo method defined in the app.js file. 
  </script>
</body>
</html>

foo yönteminin tanımlanmamış bir bar yöntemini çağırdığını varsayalım:

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

Sayfa yüklendikten sonra aşağıdaki hata yakalanır:

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

Aslında bu bir JS hatası değildir. Tarayıcılar güvenlik gerekçesiyle diğer kökenlere ait JS dosyaları tarafından oluşturulan belirli hataları bilinçli olarak gizler. Böylece hassas bilgilerin denetlenmeyen üçüncü taraf komut dosyaları tarafından istem dışı yakalanması etkili biçimde önlenir. Bu nedenle yalnızca aynı kökende bulunan komut dosyaları belirli hata iletilerini yakalayabilir; diğer kökenlerdeki komut dosyaları ise hataları algılayabilir ancak belirli hata iletilerini yakalayamaz. Daha fazla bilgi için bkz. .

bool ScriptExecutionContext::sanitizeScriptError(String& errorMessage, int& lineNumber, String& sourceURL)
    {
        KURL targetURL = completeURL(sourceURL);
        if (securityOrigin()->canRequest(targetURL))
            return false;
        errorMessage = "Script error.";
        sourceURL = String();
        lineNumber = 0;
        return true;
    }

Aşağıdaki bölümlerde komut dosyası hatalarının nasıl çözüleceği açıklanmaktadır.

Çözüm 1: Kökenler arası kaynak paylaşımını etkinleştirin

Kökenler arası JS hatalarını yakalamak için aşağıdaki adımları uygulayın:

  1. crossorigin="anonymous" niteliğini ekleyin.

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

    Bu adım, tarayıcının üçüncü taraf komut dosyalarını anonim olarak almasını sağlar. Yani tarayıcı komut dosyalarını isterken çerezler ve HTTP sertifikaları gibi potansiyel kullanıcı kimlik bilgilerini sunucuya göndermez.

  2. Kökenler arası HTTP yanıt üst bilgisini ekleyin. Örneğin aşağıdaki komutu çalıştırabilirsiniz:

    Access-Control-Allow-Origin: * 

    Alternatif olarak aşağıdaki komutu da çalıştırabilirsiniz:

    Access-Control-Allow-Origin: http://test.com 
    Not

    Varsayılan olarak çoğu ana akım CDN'de Access-Control-Allow-Origin niteliği bulunur. Aşağıdaki örnek Alibaba Cloud CDN'den alınmıştır:

    $ curl --head https://retcode.alicdn.com/retcode/bl.js | grep -i "access-control-allow-origin"
    => access-control-allow-origin: *

Yukarıdaki iki adımı tamamladıktan sonra kökenler arası hataları window.onerror işleyicisiyle yakalayabilirsiniz. Önceki örnekte sayfa yeniden yüklendikten sonra aşağıdaki hata yakalanır:

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

Çözüm 2: try catch komutunu ekleyin (İsteğe bağlı)

HTTP isteğine veya yanıt üst bilgisine kökenler arası bir nitelik eklemek zor olduğunda try catch komutunu ekleyin.

Önceki HTML sayfasına try catch komutunu ekleyin. Aşağıdaki kodda bir örnek sunulmaktadır:

<!doctype html>
<html>
<head>
  <title>Test page in http://test.com</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);
  }
  try {
    foo(); // Invokes the foo method defined in the app.js file.
  } catch (e) {
    console.log(e);
    throw e;
  }
  </script>
</body>
</html>

Sayfayı yeniden yükleyin. Aşağıdaki bilgiler döndürülür:

=> ReferenceError: bar is not defined
     at foo (http://another-domain.com/app.js:2:3)
     at http://test.com/:15:3
=> "Script error.", "", 0, 0, undefined

try catch komutu konsol günlüğünde eksiksiz hata bilgileri oluşturur ancak window.onerror işleyicisi yalnızca komut dosyası hataları oluşturur. Try catch komutunda yakalanan özel durumları manuel olarak bildirebilirsiniz. Daha fazla bilgi için bkz. SDK methods.

__bl.error(error, pos);
Not

try catch komutuyla bazı özel durumlar yakalanabilse de Çözüm 1'i kullanmanızı öneririz.

ARMS'de komut dosyası hatalarını nasıl yok sayabilirim?

Komut dosyası hataları genellikle üçüncü taraf alan adları altındaki komut dosyalarından kaynaklanır. Komut dosyası hataları uygulamanızın çalışmasını etkilemiyorsa ARMS ön uç izleme SDK'sının ignore parametresini ayarlayarak bu hataları yok sayabilirsiniz.

ignore parametresi belirtilen JS hatalarının bildirilmesini yok saymanıza olanak tanır. Bu parametrenin değeri ignoreUrls, ignoreApis ve ignoreErrors olmak üzere üç özellik içeren bir nesnedir. Aşağıdaki kodda bu parametrenin varsayılan değeri gösterilmektedir:

ignore: {
    ignoreUrls: [],
    ignoreApis: [],
    ignoreErrors: []
},

Komut dosyası hatalarını yok saymak için ignoreErrors özelliğini kullanın. ignoreErrors özelliği belirtilen bir kurala uyan JS hatalarını yok saymak için kullanılır. Bu özelliğin değeri bir dize (String türü), normal ifade (RegExp türü), yöntem (Function türü) veya önceki üç türü içeren bir dizi olabilir. Aşağıdaki kodda komut dosyası hatalarının nasıl yok sayılacağına ilişkin bir örnek verilmiştir:

__bl.setConfig({
    ignore: {
        ignoreErrors: /^Script error\.?$/
    }
});

İlgili konular