Internet Explorer Compatibility Mode Breaks JQuery

JQuery DatePicker JavaScript Error
JQuery DatePicker JavaScript Error

In this article I’ll cover some of the strange behavior I’ve noticed when working with JQuery/JavaScript for Internet Explorer.

In my tests, this behavior spans various versions of IE ranging from the older IE7 and IE8, and the more modern IE9 and IE10.

So what exactly has been happening? I would write code on my local machine where it would run just fine. However when I would move it to a development server the scripts would mysteriously fail.

The image to the left shows the kind of error report I saw when trying to plug in a JQuery DatePicker. The JQuery code was minimal so I knew the problem was not with the code.

I had seen similar problems with JavaScript a few days before, so I was determined to find the culprit.

Here is the HTML for the test page I created to track down the problem. As you can see, the JQuery code is minimal and as the picture above shows, is a simple text box with an associated JQuery DatePicker.

<html><head>
<link REL="stylesheet" TYPE="text/css" href="MyStyleSheet.css" />
 <link rel="stylesheet" href="http://ajax.googleapis.com/ajax/libs/jqueryui/1.8.16/themes/base/jquery-ui.css" type="text/css" media="all" />
 <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.2/jquery.min.js" type="text/javascript"></script>
 <script src="http://ajax.googleapis.com/ajax/libs/jqueryui/1.8.16/jquery-ui.min.js" type="text/javascript"></script>
 <script type="text/javascript" language="javascript">
 $(function() {
 $( "#datepicker" ).datepicker();
 });
 </script>
</head>
<body><input type="text" id="datepicker">
</body></html>

I am using a local development machine that did not report an error and a development server that did. I am running IE9 as a test browser. When I ran the page from my local IIS I would not see the error, but when I would run the page via the local Intranet from the development server the error would always appear.

From what i could tell, somehow my browser would attempt to load my test page but would give an error when serving a page via the local intranet.

Compatibility View Option for IE9
Compatibility View Option for IE9

As it turns out this behavior is due to a feature that Microsoft added to it’s latest browsers called Compatibility View, which is enabled by default. Compatibility View is Microsoft’s way of maintaining its support for older coding standards and IE-only markup that was in common use a few years ago when people would code for IE6 and IE7.

Microsoft is attempting to become more standards compliant in its newer browsers, so the Compatibility View switch was added so that the latest browser version would not break older code. So, by Default IE9 serves up HTML pages as if it was running as a much older version of IE, which was quite a surprise to me since the simplest JavaScript and the simplest JQuery would not behave the way I expected it to. From the documentation online I believe IE would scale itself down to IE5 ‘Quirks’ mode.

Using the Compatibility View option in the IE9 Tools menu I was able to easily create the error condition and then remove it, so this was definitely the cause of the problem.

However, now the issue for me was that the users of the system I was coding for were all on the local Intranet and would be using IE with its default settings, which meant that everyone’s IE Compatibilty View would be enabled.

Luckily there is a direct way using meta tags to tell IE what IE version it should run under when presenting a document in Compatibilty View.

Using the meta tag below I was able to tell IE to emulate IE9. I added this meta tag directly below my <head tag, and it solved the problem of IE’s Compatibilty View being enabled by default.

<meta http-equiv="X-UA-Compatible" content="IE=9" >

If you want to support a number of compatibility modes, you can specify the range as an ascending order comma-separated list (shown below). IE will then choose the highest of the specified modes that it can support.

<meta http-equiv="X-UA-Compatible" content="IE=5,8,9" >

If you declare your HTML doctype header in the HTML5 standard, IE is smart enough to know that it should emulate IE9+ without needing a meta tag to tell it what to do. In this case, start your page with the following header tag:

<!doctype html>

If you are running a .NET site, you can specify the default Compatilbility View for your entire site in the CustomHeaders section of your Web.config file as follows:

<customHeaders>
<clear />
<add name="X-UA-Compatible" value="IE=9" />
</customHeaders>

Finally, if you have access to IIS, then you can specify the Compatibility View meta tag using a custom HTTP response header.

The modes that IE supports to date are for IE versions 5, 7, 8, and 9. While looking through the Microsoft documentation, I saw reference to setting the meta tag to something called Edge mode. One can use Edge mode to  tell IE to always use the maximum possible compatibility mode supported by the browser. I tested using this setting and it did work to make IE scale up to IE9. Here is the code for the tag:

<meta http-equiv="X-UA-Compatible" content="IE=Edge" >

Conclusion:

Microsoft has added several emulation options that one can use to tell IE to run in a particular browser mode, which will be useful to know for the future.

Based on my online search I see that a lot of people have trouble with this new feature in IE. I am not sure if I consider it a good or a bad feature myself, but I can see that it could be beneficial for programmers since it gives them more control over the page they are providing. However, if the ability to specify a browser’s compatibility mode is to become a mainstream feature, then it needs to be implemented by other browser makers in order to avoid it becoming just another IE-specific quirk.

References:

31 responses to “Internet Explorer Compatibility Mode Breaks JQuery”

  1. […] I’m speaking of course about IE8 & 9′s notorious “Compatibility Mode“. I’ve written about this “feature” before, but just to summarize, compatibility mode was added to IE8+ to save IE6 developers from having to […]

  2. This saved my bacon… Thank you very, very much!

    1. I’m happy it was useful to you, Cheers!

  3. AndyfromTucson Avatar
    AndyfromTucson

    I had a problem with IE9 using Compatibility View on my web page and breaking the Datatables jQuery plug-in. I fixed it by adding the IE=Edge meta tag you describe. Some odd things I noticed along the way to finding a solution:

    – It seemed that not all installs of IE9 forced Compatibility View on my page (i.e. some IE9 users never had a problem, while others did).

    – My page had the !doctype html tag all along, but the Compatibility View issue still happened and was only fixed by your meta tag.

    – Even weirder, Compatibility View did not break by Datatables jQuery plug-in on at least one install of IE9 (i.e. the page worked fine even when I manually turned on Compatibility View).

    1. Thanks for sharing your findings; it’s definitely strange how Compatibility view in some installs of IE9 will work with JQuery while not with others. It’s good that the meta tag forces IE to run in IE9 standards mode since Compatibility view seems to introduce more problems than benefits.

    2. Same problem and same solution :)

  4. Thanks so much for taking the time to share this. Saved me a big headache!

    1. Not a problem, glad the article was useful!

  5. […] Have a look at an article I wrote on the subject to find out more about browser compatibility mode and JQuery . […]

  6. I was having the same problem: our architecture requires X-UA-Compatible to force IE=5. Finally I found a solution that enabled jQuery + IE Quirks. I found that we had some objects defined like this: {‘a’:’a’, ‘b’:’b’,}. The problem was that last comma – IE Standards handles it well, IE Quirks throws a JavaScript error. Maybe the plugins or code you are using have this problem? This was on IE8, haven’t tested IE9/10 yet.

  7. i was having the same problem update panel not working in ie10 ……Using the Compatibility View option in the IE10 Tools menu manually update panel work properly…. i dont want change every time Compatibility View
    setting …u have solution for this query please revert back..

  8. i am trying u r bellow code…but its till not working

  9. I filled dropdownlist on the basis of text box change i.e.(inside text change event) in asp.net page using updatepanel to avoid postback its working fine in IE 7,8,9 but its not working on IE 10

    1. Hi Vishal,

      Microsoft has changed a number of things in IE 10 and IE 11. I am not sure what your code looks like, but try seeing if setting works.

      With IE 10 and IE 11 another problem can be that IIS is not detecting the new browser signatures. I had the same problem a while ago. This problem can be solved by setting Page.ClientTarget = “uplevel”; in the page load event. I give some more detail in this article: https://jwcooney.com/2013/11/19/asp-net-doesnt-detect-ie11/

      I hope this helps,

      Justin

  10. Hi justin,

    When i change the compatibility view setting its working fine.but i don’t want to compatibility view setting every time.

  11. I have set Page.ClientTarget = “uplevel” at the page_load event
    But entire page is again post back to the server

  12. Thanks a lot!!!

    1. You are welcome, I am glad the article was helpful.

  13. Wow! Thanks! I’ve been chasing this tail for months.

  14. Many thanks for this – was scratching my head over this one.

  15. I have been tracing this problem for 3 hours in server setting. You saved my life!
    Stupid IE!!!

    1. I’m glad the info was helpful! Have a great day.

  16. Justin, Thanks a lot. You saved my day… I was searching for this for a long time…

    1. Hi, I am glad the article was helpful, have a great day!

  17. Thanks man–just what I needed!

    1. Hey, I am glad it helped!

  18. Thank you so much!

    worked like magic.

  19. Thanks Justin! This did the trick

    1. Glad it was useful, thanks for your feedback!

  20. Alaistar Cook Avatar
    Alaistar Cook

    How to restrict my web application to run only in Chrome..
    Thanks in Advance

Leave a comment