Sunday, December 28, 2008

Can Selenium detect if the page has JavaScript errors?

We usually have common requirement for Selenium: Check JS error in step.

Use case like:
1. beginJsErrorChecker
2. open | http://containJSError.jsp
3. open | http://noissueJS.jsp
4. endJsErrorChecker
It can report url2 has jserror in Selenium:
[error] JsErrorChecker:[JavaScript Error: "foo is not defined" {file: "http://containJSError.jsp" line: 9}]
It's hard to provide a generic solution for all browsers but my team implements above scenario for Selenium IDE only by Firefox chrome Error Console XPCOM APIs.

user-extensions.js like:
 
if (browserVersion.isChrome) {
  var theConsoleListener = {
     stepIdx:0, //beginJsErrorChecker command index
     observe:function( aMessage ){//async!
        dump("Log : " + aMessage.message);
        //Error, Warning, Message too noise. We only report "[JavaScript Error:..."
        if(aMessage.message != null && aMessage.message.indexOf("[JavaScript Error:") == 0){ 
          LOG.error("JsErrorChecker:" + aMessage.message);
                  
          //throw new SeleniumError("Catch JS Error: " + aMessage.message);
          //can't throw exception here: pollution to target JSError
          //so we manually markFailed
          
          //IDE only
          var olddebugIndex = testCase.debugContext.debugIndex;
          testCase.debugContext.debugIndex = this.stepIdx;//set actual index
                  
          testCase.debugContext.failed = true;
          testCase.debugContext.currentCommand().result = 'failed';
          editor.view.rowUpdated(testCase.debugContext.debugIndex);
                  
          testCase.debugContext.debugIndex = olddebugIndex;//recover
        } 
   },
   QueryInterface: function (iid) {
        if (!iid.equals(Components.interfaces.nsIConsoleListener) &&
              !iid.equals(Components.interfaces.nsISupports)) {
            throw Components.results.NS_ERROR_NO_INTERFACE;
            }
        return this;
   }
  }; 
}
 
Selenium.prototype.doBeginJsErrorChecker = function(){
  try {
    if (browserVersion.isChrome) {// firefox 
          theConsoleListener.stepIdx=testCase.debugContext.debugIndex;//set current step idx for async call
          var aConsoleService = Components.classes["@mozilla.org/consoleservice;1"]
                          .getService(Components.interfaces.nsIConsoleService);
          aConsoleService.registerListener(theConsoleListener);
          aConsoleService.reset();
    }else{
      throw new SeleniumError("TODO: Non-FF browser...");
    }
    } catch (e) {
    throw new SeleniumError("Threw an exception: " + e.message);
    }
};

Selenium.prototype.doEndJsErrorChecker = function(){
  try {
    if (browserVersion.isChrome) {// firefox  
          var aConsoleService = Components.classes["@mozilla.org/consoleservice;1"]
                          .getService(Components.interfaces.nsIConsoleService);
          aConsoleService.unregisterListener(theConsoleListener);
          aConsoleService.reset();
    }else{
      throw new SeleniumError("TODO: Non-FF browser...");
    }
    } catch (e) {
    throw new SeleniumError("Threw an exception: " + e.message);
    }
};
I just add a Selenim listener to Firefox Error Console to make jserror checker work for Selenium-IDE.
Because it is async mode to check JSError, we treat beginJsErrorChecker failed if any step contains JSError in begin...end block.
We also filter all Warning and Message in Error Console, treat Error only as failed here.

I pasted solution on http://clearspace.openqa.org/message/52135
http://jira.openqa.org/browse/SEL-613

Saturday, December 27, 2008

Selenium1.0b buglist for Firefox 3 Chrome TestRunner

There are a lot of bugs in Selenium1.0b to run on Firefox 3 with chrome TestRunner.html.

I list them here:
1. CSS/Resource issue: http://jira.openqa.org/browse/SIDE-222
2. Permission Denied issue: http://jira.openqa.org/browse/SEL-612
3. waitForPopUp issue: http://jira.openqa.org/browse/SIDE-228
4. click link issue: http://jira.openqa.org/browse/SEL-614
5. UI-Element not work issue: http://sejq.blogspot.com/2008/12/fix-ui-element-cant-run-bug-in-chrome.html

Sunday, December 21, 2008

Two Javascript synchronous sleep functions which won't freeze browser

Javascript didn't provide Thread.sleep(ms) method like Java which is useful for synchronization.

Most of time we can solve Javascript synchronization by use setTimeout or setInteval. However, using setTimeout requires you to split your function up into discrete processes, which is hard to do for some Javascript logic. What we really need is a free-standing function that could be added inline to any block of code to share the processor on the fly.

I encounter a scenario in Selenium today: I want Javascript to sleep to wait for an async call. It's much harder than I thought to implement it. Think about below code:
function sleep(delay) {
   var startTime = new Date();
   var endTime = null;
   do {
       endTime = new Date();
   } while ((endTime - startTime);
} 
It looks fine but if you try it, you will find CPU is very busy executing the while loop and freeze browser. This is not what we wanted.

I got 2 workaround methods. The keypoint is JS NOT freeze CPU/browser during sleep:
1)javascript sleep 1: use XMLHttpRequest to do sync call for sleep.jsp
function wbsleep(ms) { 
  var   startDate = new Date();   
  while((new Date()-startDate) < ms){   
      var xmlHttpReq; 
      try {
         // for IE/ActiveX
         if(window.ActiveXObject) {
             try {
                 xmlHttpReq = new ActiveXObject("Msxml2.XMLHTTP");
             }
             catch(e) {
                 xmlHttpReq = new ActiveXObject("Microsoft.XMLHTTP");
             }
         }
         // Native XMLHttp
         else if(window.XMLHttpRequest) {
             xmlHttpReq = new XMLHttpRequest();
         } 
                tempurl = "http://localhost/sleeputil.jsp?sleepms="+ms;
         xmlHttpReq.open("GET", tempurl, false); // synchron mode  
         xmlHttpReq.send(null);
      }
      catch(e) {  
      } 
  }
};
The sleeputil.jsp is very simple, get request parameter sleepms and then do a Java Thread.sleep(sleepms) in doGet. This method is suitable for all browsers but need you provide a server side sleeputil.jsp.

2)javascript sleep 2: XPCOM on Firefox chrome only
/**
 * Netscape compatible WaitForDelay function.
 * You can use it as an alternative to Thread.Sleep() in any major programming language
 * that support it while JavaScript it self doesn't have any built-in function to do such a thing.
 * parameters:
 *  (Number) delay in millisecond
*/
function nsWaitForDelay(delay) {
  try{
    /**
    * Just uncomment this code if you're building an extention for Firefox.
    * Since FF3, we'll have to ask for user permission to execute XPCOM objects.
    */
    netscape.security.PrivilegeManager.enablePrivilege("UniversalXPConnect");

    // Get the current thread.
    var thread = Components.classes["@mozilla.org/thread-manager;1"].getService(Components.interfaces.nsIThreadManager).currentThread;

    // Create an inner property to be used later as a notifier.
    this.delayed = true;

    /* Call JavaScript setTimeout function
     * to execute this.delayed = false
     * after it finish.
     */
    setTimeout("this.delayed = false;", delay);

    /**
     * Keep looping until this.delayed = false
    */
    while (this.delayed) {
        /**
         * This code will not freeze your browser as it's documented in here:
         * https://developer.mozilla.org/en/Code_snippets/Threads#Waiting_for_a_background_task_to_complete
        */
        thread.processNextEvent(true);
    }
  }catch(e) {  
  } 
}
This is especially suitable for Selenium CORE*ffchrome.

Saturday, December 20, 2008

Automate HttpFox(HttpWatch) test case for http traffic manipulation in Selenium

Selenium can verify and store values by DOM on current page easily. However, it's hard for Selenium to do manipulation on http traffic like POST Data, http headers, Query String and Content sniffer.

I know many QA did http traffic testing manually by 2 famous software:
1) HTTPWatch: commercial. support both IE and Foxfox.
2) HTTPFox: free, opensource. a Firefox extension.

One day, a guy came to my cube and raised a question: Can I stop my tons of manual functional testing with HttpFox, but use Selenium to automate them? Is it possible that we create a bundle of Selenium APIs to manuplate Http Traffic Sniffer operations?

Yes, we should add this important feature to Selenium. I finished a beta version to support HttpFox APIs in Selenium:
1) merge httpfox.xpi into Selenium-IDE.xpi
2) leverage XPCOM in httpfoxservice.js HTTPFox provided
3) create Selenium APIs and print http traffic info to Selenium LOG:
startHttpFox4Sel
stopHttpFox4Sel
clearHttpFox4Sel
verifyTextInHttpFoxURLs(Not)Present | textpattern
verifyTextInHttpFoxContent(Not)Present | urlpattern | textpattern
storeContentInHttpFoxByURL | urlpattern | varname
verifyParamInHttpFoxQueryString(Not)Present | urlpattern | param1=value1,param2=value2 list
storeParamInHttpFoxQueryString | param@urlpattern | varname
verifyParamInHttpFoxPostData(Not)Present | urlpattern | param1=value1,param2=value2 list
storeParamInHttpFoxPostData | param@urlpattern | varname
...

Source draft:
Selenium.prototype.doStartHttpFox4Sel = function() {
    try {
     if(browserVersion.isChrome){
      HttpFox.cmd_hf_clear();
         HttpFox.cmd_hf_startWatching(); 
        }
    } catch (e) {
     throw new SeleniumError("Threw an exception: " + e.message);
    }
}; 

Selenium.prototype.doStopHttpFox4Sel = function() {
    try {
        if(browserVersion.isChrome){ 
         HttpFox.cmd_hf_stopWatching();
         HttpFox.cmd_hf_clear();
        }
    } catch (e) {
     throw new SeleniumError("Threw an exception: " + e.message);
    }
}; 

Selenium.prototype.doClearHttpFox4Sel = function() {
    try {
        if(browserVersion.isChrome){  
         HttpFox.cmd_hf_clear();
        }
    } catch (e) {
     throw new SeleniumError("Threw an exception: " + e.message);
    }
}; 
       
Selenium.prototype.isTextInHttpFoxURLsPresent = function(pattern) {
   try {
     if(browserVersion.isChrome){  
   for (var i = 0; i < HttpFox.HttpFoxService.Requests.length; i++){ 
        var request = HttpFox.HttpFoxService.Requests[i];
        //1.Time:
        var time = formatTimeDifference(request.StartTimestamp, request.EndTimestamp) ;
        //2.Sent:
        var sent = "";
        if (request.IsSending){
          sent = humanizeSize(request.getBytesSent(), 6) + "/" + humanizeSize(request.getBytesSentTotal(), 6);
        }
        else {
         sent = humanizeSize(request.getBytesSentTotal(), 6); 
        } 
        //3.Received:     
         var received = "";
         if (request.IsSending){
          received = "*";
       }
       if (!request.IsFinished){
          // show loading body progress
         received = humanizeSize(request.getBytesLoaded(), 6) + "/" + humanizeSize(request.getBytesLoadedTotal(), 6);
       }else{
         received = humanizeSize(request.getBytesLoaded(), 6); 
       }
       if (request.IsFromCache || request.ResponseStatus == 304){
         received = "(" + received + ")";
       } 
        //4.Method:
       var method = request.RequestMethod; 
        //5.Result: 
        var result = "";
       if (request.IsAborted){
         result =  "(Aborted)";
       }else if (request.isError()){
          result = "(Error)";
       }else if (request.IsFromCache && (request.ResponseStatus != 304)) {
          result =  "(Cache)";
       }else if (!request.HasReceivedResponseHeaders && !request.IsFinal){
          result = "*";
       }else{
           result =  request.ResponseStatus;
       } 
        //6.Type:
              var type = "";
              if (request.hasErrorCode()){
               if (request.ContentType){
               type =  request.ContentType + " (" + request.Status.toString(16) + ")";//we omit nsResultErrors translate
              }else{
               type =  request.Status.toString(16);
              }
             }else if (!request.HasReceivedResponseHeaders && !request.IsFromCache && !request.IsFinal){
               type =  "*";
             }else if (request.isRedirect()){
              if (request.ResponseHeaders && request.ResponseHeaders["Location"]){
               type =  "Redirect to: " + request.ResponseHeaders["Location"]; 
              }else{
               type =  "Redirect (cached)";
              }
             }else{
              type = request.ContentType;     
             }  
       //7.URL
       var urlstring = request.Url ;
       //TODO: LOG.info(http sniffer info);
       //TODO: verify as you like by PatternMatcher
   } //end for
    }//end chrome
    } catch (e) {
     throw new SeleniumError("Threw an exception: " + e.message);
    }
}; 

Now, QA can automate HttpFox steps in Selenium. They don't need to do http traffic testing manually all days.

Dedicated to developing Selenium Core Firefox chrome branch

Since my team has chosen Selenium Core-Firefox chrome with Selenese table test case as primary Selenium testing method, my task will focus on Selenium Core Firefox chrome branch development(A brand new Selenium-IDE). I will also contribute a bundle of Java APIs to play Selenium Core*ffchrome. Moreover, I should provide a GRID framework for huge test case number run.

"Simply the best". No proxy server, no Remote Control, no IE/HTA, no Java Test Case, no Same Origin Policy, I really found this mode is efficient but powerful as long as we provide an enterprise framework.

For QA, they only need learn Selenese table knowledge without Java programming skills. They don't need to install any complex framework but only setup our Selenium-IDE version on their desktop.

For framework developer, then needn't build a heavyweight infrastructure like proxy server, client driver. What they need do are only:
1) Let Selenium-Core*ffchrome save detailed enough result capture/snapshot with well formed structure to local file system.
2) Extend chrome URL parameters to meet all configuration requirements. We can benifit a lot from Mozilla APIs and do some fantasitic jobs for Selenium core(That why we choose Firefox as Selenium browser).
3) A bundle of Java APIs to play Selenium-Core*ffchrome under isolated profile and parse run results to Java Objects. We can define an atomic unit(1-3) as one Selenium Agent.
4) A GRID Java framework to distribute huge test case number run on Agents with scalability. DB support is necessary to save both test case info and run result info.
5) Then a GUI web based test case maintenance and execution portal is possible with above back end framework supporting.

Comparing to official RC+GRID solution, our solution is more suitable for acceptance test, integrating test & regression test(black box).

Monday, December 15, 2008

Selenese flowControl extensions - advanced support for include template

As my previous post, Selenese flowControl extensions work well on IDE and Core now. However, when guys used another powerful extension 'include', they found flowControl not work in include template steps.

I provide a quick workaround here. Please revise include extension javascript as below:
Selenium.prototype.doInclude = function(locator, paramString) {
    LOG.debug(IncludeCommand.LOG_PREFIX + " Version " + IncludeCommand.VERSION);
    var includeCommand = new IncludeCommand();
    includeCommand.doInclude(locator, paramString);
  
     //Jerry Qian: add flowControl support for include template steps
     try{
       htmlTestRunner.currentTest.gotoLabels  = {};
       htmlTestRunner.currentTest.whileLabels = { ends: {}, whiles: {} };
       htmlTestRunner.currentTest.initialiseLabels();
     }catch(e){}
     //End flowControl
};
Include template steps can use flowControl commands now.

Saturday, December 13, 2008

Selenese flowControl extensions

Usually, we don't need to do conditional logic in Selenese table. Selenium RC programming language is more suitable for complex logic. But sometimes we still want to add some conditional steps in Selenese, like if...else, while.

Fortunately, there are already flow control extensions on openqa's wiki.
http://wiki.openqa.org/display/SEL/flowControl

It can meet most of flow control requirements for Selenese. We still recommend use RC to implement more complicated logic.

Also some people work on both Core and IDE. They found this extensions not work on IDE. It's a CORE version.

One guy contributed an IDE version: http://51elliot.blogspot.com/2008/02/selenium-ide-goto.html. IDE user can also use it.

So I combined them to a unified flowControl extensions: support both IDE and CORE.

The simplest code:
var sel_locstr = window.location.href;  
if(sel_locstr.indexOf("selenium-ide.xul") != -1){ //IDE mode      
   // paste IDE extension here
}else{//Core mode
   // paste Core extension here
} 
Enjoy!

Friday, December 12, 2008

Firefox3 new security rule: Selenium no CSS on Chrome TestRunner

Firefox 3 introduced more strict security rules than older version. Many Selenium weird issues on FF3 are related to it, while most of these issues didn't happen on FF2.

Today I encountered one SeleniumIDE1.0b2 bug: [SIDE-222]Test execution is not possible in chrome mode in Firefox 3.

FF3 Error Console reported:
Security Error: Content at (local test suite html address like file:///c:/seltest/testsuite1.html) may not load or link to "chrome://selenium-ide-testrunner/content/selenium/selenium-test.css" 
It seems FF3's default security settings not allow external file access chrome:// resource.
I read Mozilla docs: https://developer.mozilla.org/en/Chrome_Registration#contentaccessible

It said: (New in FF3) Chrome resources can no longer be referenced from within <img>, <script>, or other elements contained in, or added to, content that was loaded from an untrusted source. This restriction applies to both elements defined by the untrusted source and to elements added by trusted extensions. If such references need to be explicitly allowed, set the contentaccessible flag to yes to obtain the behavior found in older versions of Firefox.

So, I try to modify Selenium-IDE1.0b2's chrome.manifest file.
content selenium-ide-testrunner jar:chrome/selenium-ide.jar!/content/ xpcnativewrappers=no 
content selenium-ide-testrunner jar:chrome/selenium-ide.jar!/content/ xpcnativewrappers=no contentaccessible=yes
SeleniumIDE1.0b2 displayed CSS correctly this time on FF3 Chrome TestRunner.

Wednesday, December 3, 2008

Test Flex/Flash in Selenium

There are many automation tools for testing Flex & Flash RIA web page, like TestComplete, QTP. However, they are all not free. It's good news if Selenium supports such kind of RIA testing.

We found there are some interesting projects on Selenium for Flex/Flash testing.

Here is a topic: http://www.agimatec.de/blog/2008/11/selenium-flex-tests-with-maven/

Introduction:
SeleniumFlexApi is in one part a Flex library which needs to be included in your app and on the other part an extension to the Selenium IDE. I like the Flex part, because it makes it easy to dive over Javascript into the details of your Flex app. What I don’t really like is the Javascript extension. Yes, it is not only a Selenium IDE part and you can include it into the start of the Selenium Server, but it is far away from Java and Maven.

FlashSelenium is a piece of code which let’s you talk from Java over Selenium with your Flex app. The Java part is very handy, but you need to code into Flex, which methods you could call over your bridge. So I need to write special code, which opens the bridge. The SeleniumFlexAPI is much better in this part.

Monday, December 1, 2008

Fix ui-element can't run bug in Chrome TestRunner mode

Selenium-IDE1.0b2 introduced a new feature: UI-Element. It is very useful feature for annoyed XPATH EL.

We try demo in Selenium IDE panel successfully. However, when we try UI-Element test case in Chrome TestRunner, even if we set &userExtensionsURL=chrome://selenium-ide/content/ui-element.js,file:///c:/ui/my-ui-map.js correctly in chrome URL, it failed to load any UI-Element feature.

Weird, we have discussed it on openqa forum. Finally, I fix this bug in chrome://selenium-ide/content/ui-element.js
function is_IDE()
{      
 //[Begin Fix]
 var locstr = window.location.href;  
 if(locstr.indexOf("selenium-ide.xul") != -1){
     //IDE mode   
     return true;
 }else{
     return false; 
 }
 //[End]
 return (typeof(SeleniumIDE) != 'undefined');
}
It seems
typeof(SeleniumIDE) != 'undefined'
not work in Chrome TestRunner mode.

Finally, with above fix, UI-Element works in both IDE and Chrome TestRunner.

More discussion: http://clearspace.openqa.org/message/53306

Tuesday, November 18, 2008

Write user-extensions.js working for both Selenium-IDE and Selenium-Core

Sometimes we found our user-extensions.js(like include cmd)work on Selenium-Core but error on Selenium-IDE, or vise versa.

The reason is IDE and Core used 30% different js objects.

We can write below style user-extension to support both IDE and Core.
Sample:
if(IDE_MODE){
   //IDE manner
}else{//CORE_MODE
   //Core manner
}
The key function here is how to determine current mode type by javascript?
Simple workaround code:
function isIDE(){
  var locstr = window.location.href;  
  if(locstr.indexOf("selenium-ide.xul") != -1){
      //IDE mode   
      return true;
  }else{
      return false; //Core mode
  }
}

Monday, November 17, 2008

Multiple Profiles running simultaneously synchronization in SeleniumJRunner

We must assign each SeleniumJRunner a unique profile name at one time.
Otherwise, if 2 instances use the same profile name at one time, Firefox will report "Firefox is already running..." error.

Assume we have pre-created Firefox profiles on one machine with name:
testprofile1
testprofile2
testprofile3
...
testprofile9

We can lock profile name when one SeleniumJRunner is using it and unlock it when SeleniumJRunner quit. If there is no free profile name, let new SeleniumJRunner wait.

Sample code:
public static String lockAndGetAvailableProfile(String[] allProfiles) { 
  FileLock lock = null; 
  for (int i = 0; i < allProfiles.length; i++) {
   try {
    RandomAccessFile raf = new RandomAccessFile(PROFILE_LOCK_FOLDER 
                        + "/" +i+".lck" , "rw");
    FileChannel fileChannel = raf.getChannel();
    lock = fileChannel.tryLock();
    if(lock != null && lock.isValid()
       && !lock.isShared()){ 
     return allProfiles[i];
    }else{
     lock = null;
     fileChannel.close();
     raf.close();
    }
   } catch (IOException ioe) {
    ioe.printStackTrace();
   } 
  }
  return "No available profile";
}

Sunday, November 16, 2008

Daemon AutoIt3 process to click popup and alerts for Selenium

There are always all kinds of popup and alerts during selenium running. If they are not clicked out, Selenium may be blocked and timed out.

We recommend to use a free tool AutoIt3 to write daemon scripts to click out any popup. Make sure selenium run smoothly.

Sample Autoit3 scripts:
If WinExists("Alert") Then
    WinActivate("Alert")
    ControlSend ("Alert", "", "", "{SPACE}")
    ContinueLoop
EndIf

Saturday, November 15, 2008

Customize Selenium Chrome TestRunner profile in JRunner

There is a prefs.js configuration file for each Firefox profile.
Selenium Java Runner can do some necessary customization before launch Firefox TestRunner instance.
Read prefs.js docs: http://kb.mozillazine.org/Prefs.js_file

Sample prefs.js customize code:
PrintStream out = new PrintStream(new FileOutputStream(prefsJS, true));
// Don't ask if we want to switch default browsers
out.println("user_pref('browser.shell.checkDefaultBrowser', false);"); 
// suppress authentication confirmations
out.println("user_pref('network.http.phishy-userpass-length', 255);");
// Disable pop-up blocking
out.println("user_pref('browser.allowpopups', true);");
out.println("user_pref('dom.disable_open_during_load', false);");
out.println("user_pref('startup.homepage_welcome_url', '');");
// Disable Restore your session dialog. Always start a new session
out.println("user_pref('browser.sessionstore.enabled', false);");
// Disable security warnings
out.println("user_pref('security.warn_submit_insecure', false);");
out.println("user_pref('security.warn_submit_insecure.show_once', false);");
out.println("user_pref('security.warn_entering_secure', false);");
out.println("user_pref('security.warn_entering_secure.show_once', false);");
out.println("user_pref('security.warn_entering_weak', false);");
out.println("user_pref('security.warn_entering_weak.show_once', false);");
out.println("user_pref('security.warn_leaving_secure', false);");
out.println("user_pref('security.warn_leaving_secure.show_once', false);");
out.println("user_pref('security.warn_viewing_mixed', false);");
out.println("user_pref('security.warn_viewing_mixed.show_once', false);");
// Disable cache
out.println("user_pref('browser.cache.disk.enable', false);");
out.println("user_pref('browser.cache.memory.enable', true);");
// Disable "do you want to remember this password?"
out.println("user_pref('signon.rememberSignons', false);");
// Disable any of the random self-updating crap
out.println("user_pref('app.update.auto', false);");
out.println("user_pref('app.update.enabled', false);");
out.println("user_pref('extensions.update.enabled', false);");
out.println("user_pref('browser.search.update', false);");
out.println("user_pref('browser.safebrowsing.enabled', false);"); 
//enable javascript 
out.println("user_pref('javascript.enabled', true);"); 
//Optional Tips: User-Agent hijack for http traffic debug
//out.println("user_pref('general.useragent.override', 'Here crack user-agent');");  out.close();

Friday, November 14, 2008

Include JS src file in Firefox Chrome Javascript file

To include a Javascript src file in HTML, it's very simple:
<script src="scripts/b.js" type="text/javascript"></script>
However, how to implement above logic in a Chrome js file(XUL missed including b.js).
There is a XPCOM API @mozilla.org/moz/jssubscript-loader;1
Sample:
const subScriptLoader = Components.classes["@mozilla.org/moz/jssubscript-loader;1"].getService(Components.interfaces.mozIJSSubScriptLoader);
 //file:/// path for XPCOM. http:// not support
subScriptLoader.loadSubScript('file:///c:/scripts/b.js', this);
In normal js file(non-chrome), it's also simple.
Sample:
document.write('<script src="scripts/b.js" type="text/javascript"></script>');
This tip is useful for Selenium-IDE enhancement.

Thursday, November 13, 2008

Security Alerts Interceptor for Selenium-IDE

There are 2 kinds of HTTPs Certification Security Alerts in Firefox.
1) Domain name mismatch
2) Certificate expired
Read http://kb.mozillazine.org/Security_Error:_Domain_Name_Mismatch_or_Server_Certificate_Expired
Unfortunately, Firefox 2 didn't provide a preferences entry to disable or hidden alerts.
These annoyed alerts slow down selenium speed and block selenium automation if we don't click out alerts.

There is a Firefox extension Remember Mismatch Domains(RMD.xpi) to add a "Don't warn me again about this certificate for this domain" checkbox to the Domain Mismatch and Expired Certificate warning windows. When selected the domain name and security certificate domain pair (or certificate and expiration date pair) is stored in a Firefox preference and the security error dialogue will be bypassed on subsequent visits.

The author provided a XPCOM to destroy Security Alerts Window before it displays in Firefox. We can integrate this XPCOM with Selenium-IDE and provide Security Alerts Interceptor feature.

Here are steps and code:
1) copy /platform folder from RMD.xpi to selenium-ide.xpi
2) copy rmdBadCertHandler.js and rmdIBadCertHandler.xpt to /components folder
3) edit rmdBadCertHandler.js
_isRemembered: function (handler_type, target_url, cert) {
   return true;
   //intercept and kill all security alerts
   //or add a preference entry here and return true or false
   ...
}
NOTE: it is used for Firefox 2 only. Firefox 3 has a new security exception handler.

Tuesday, November 11, 2008

Selenium close all Firefox windows in profile when finish run

There is a Chrome URL parameter &close=true in Selenium-IDE. When set to true, it will automatically close Selenium Firefox windows when finish run. However, if application window has popuped child windows like ads, selenium can't close these popup windows when quit.

This has risk to lock Firefox profile when multiple Firefox profiles running simuteniously. Please refer to "Firefox is aleady running issue"
Enhance Selenium-IDE by XPCOM API: close all Firefox windows under current profile. Add logic when Selenium quit(close=true).
Sample code:
var windowManager = Components
  .classes['@mozilla.org/appshell/window-mediator;1'].getService();
var windowManagerInterface = windowManager
  .QueryInterface( Components.interfaces.nsIWindowMediator);
var enumerator = windowManagerInterface.getEnumerator( null );
var appStartup = Components
  .classes['@mozilla.org/toolkit/app-startup;1'].
  getService(Components.interfaces.nsIAppStartup);
while ( enumerator.hasMoreElements()  )
{
  var domWindow = enumerator.getNext();
  if (("tryToClose" in domWindow) 
       && !domWindow.tryToClose())
    return false;
  domWindow.close();
};
appStartup.quit(Components.interfaces.nsIAppStartup.eAttemptQuit);

Monday, November 10, 2008

Save to local files with XPCOM for Selenium Firefox Chrome

We save selenium run snapshot/result/log to local files instead of complex POST to server solution. We require APIs in browser(out of Security Sandbox) for local files accessing.

In IEHTA, there is ActiveX object FSO to access local files.
var objFSO = new ActiveXObject("Scripting.FileSystemObject");
Is there a similar object in Mozilla Firefox Chrome?
The answer is XPCOM object @mozilla.org/file/local;1

Save to file Sample:
function saveFile(fileName, val){
   try {
      netscape.security.PrivilegeManager.enablePrivilege("UniversalXPConnect");
   } catch (e) {
      //alert("Permission to save file was denied.");
   }
   var file = Components.classes["@mozilla.org/file/local;1"]
             .createInstance(Components.interfaces.nsILocalFile);
   file.initWithPath(fileName);
   if (file.exists() == false) {
     //alert("Creating file... " );
     file.create( Components.interfaces.nsIFile.NORMAL_FILE_TYPE, 420 );
   }
   var outputStream = Components.classes["@mozilla.org/network/file-output-stream;1"]
            .createInstance(Components.interfaces.nsIFileOutputStream);
   outputStream.init( file, 0x04 | 0x08 | 0x20, 420, 0 ); 
   //UTF-8 convert
   var uc = Components.classes["@mozilla.org/intl/scriptableunicodeconverter"]
     .createInstance(Components.interfaces.nsIScriptableUnicodeConverter);
   uc.charset = "UTF-8";
   var data_stream = uc.ConvertFromUnicode(val);
   var result = outputStream.write(data_stream, data_stream.length );
   outputStream.close(); 
}
We use UTF-8 encode here.

Sunday, November 9, 2008

PseudoTestRunner.html to run Selenium Chrome by cmdline

Launch Selenium Chrome TestRunner by cmdline: firefox.exe -chrome "chrome://selenium-ide-testrunner/content/selenium/TestRunner.html..." will cause many weird issues on Firefox.
I'm not sure the root cause which maybe related to Firefox Chrome Security Strategy for -chrome parameter.

Here is a workaround:
Hijack selenium-ide.xpi. Under selenium-ide\content\selenium\ add a file PseudoTestRunner.html
Source:
<html>
<head><title>Pseudo Test Runner - Used for launch Chrome by Cmdline</title></head>
<body>
  <script language="javascript"> 
  var strHref;
  var intParamsStartIndex;
  var strParams;
  strHref = window.location.href;
  intParamsStartIndex = strHref.indexOf("?");
  strParams = strHref.substring(intParamsStartIndex);
  window.open("chrome://selenium-ide-testrunner/content/selenium/TestRunner.html" + strParams);
  window.close();
  </script>
</body>
</html>
Then please always use PseudoTestRunner.html instead of TestRunner.html in cmdline, keep the same parameter list in URL.

Refer to topic: http://clearspace.openqa.org/message/51801#51801

Saturday, November 8, 2008

How to let JAVA play with Selenium Firefox Chrome TestRunner

Selenium Firefox Chrome TestRunner is written by JS/DHTML. When we want to embed Firefox Chrome TestRunner engine into our testing framework. We are asking for a way to let JAVA play with Firefox Chrome TestRunner. You can also refer to Selenium-RC source code to launch a browser. Here is a workaround solution with pseudo code.

1. In & Output of 'Selenium Firefox Chrome TestRunner' component for JAVA IN: it is usually URL trigger for running. Chrome URL with parameters looks like:
chrome://selenium-ide-testrunner/content/selenium/TestRunner.html?test=file:///c:/testing/MyTestSuite.html&auto=true&multiWindow=true&userExtensionsURL=http://localhost/user-extensions.js,http://localhost/ui/my-ui-map.js&close=true&[other self defined parms]
We can see Selenium passed parameters by chrome URL for input. We can add more self defined params by modify Selenium-IDE code.
If we can convert all parameters in JAVA to chrome URL parameters, it's possible to let JAVA invoke Selenium-IDE.

OUTPUT: one output choice provided by S-CORE is using POST data when Selenium closed. It required you create a server side receiver.
One better solution is S-IDE save run snapshot/result/log runtimely to file system directly. We treat these important data as output.

For offical docs about IN&OUTPUT, refer to http://seleniumhq.org/projects/core/usage.html

2. 'IN' Wrapper in JAVA
We create a Java Object as a chrome URL paramters wrapper, simple like:
public class SeleniumRequest implements Serializable {
 private String test; 
 private String auto;
        private String multiWindow;
...
        public String getAuto() {
  return auto;
 } 
 public void setAuto(String auto) {
  this.auto = auto;
 }
...
}
3. 'OUTPUT' Wrapper in JAVA
We also create a Java Object as atomic run result wrapper, simple like:
public class SeleniumResult implements Serializable {
 private int testRuns; 
 private int testFailures; 
        private String resultSummary;
 private String logFilePath;  
...
        public String getResultSummary() {
  return resultSummary;
 } 
 public void setResultSummary(String resultSummary) {
  this.resultSummary= resultSummary;
 }
...
}
Detailed run results are saved on file system by S-IDE. logFilePath is the path for their index file.

4. SeleniumJRunner in Java
Now, we can define a very simple & generic interface for run S-IDE in Java.
public interface SeleniumJRunner {
      public SeleniumResult run(SeleniumRequest request); 
}
We assume this run API is sync mode, which means run() will be blocked in Java thread until S-IDE finished run and generate OUTPUT.

5. SeleniumResultParser.java
S-IDE saved all results in file system, we need a Java class to parse file content and set to SeleniumResult object. This is part of SeleniumJRunner implementation logic. To do html file parser in Java, there are many opensource lib. You can use Nekohtml.

6. SyncExecutor.java
Since S-IDE is an external process for Java. We need launch it with parameters from Java in sync mode. Usually, JAVA API Runtime.getRuntime().exec() meets basic requirement. However, we need a timedout mechanism and safely execution which Runtime.getRuntime() doesn't provide. We create a powerful but simple SyncExecutor util. For related topic, refer to how to safely execute process from java

7. Launch Selenium with profile isolation on the same machine
It is super Firefox can run multiple instances with session/cache isolation concurrently on the same machine by Firefox Profiles mechanism.
We need to add -p ProfileName -no-remote parameters to Firefox cmdline.
For multiple Firefox profiles run together, refer to http://clan.yo2.cn/run-multiple-firefox-profiles-simultaneously.html

8. There is critical issue for launch Chrome TestRunner in cmdline mode
User may encounter weird issue if launch Chrome TestRunner in cmdline like firefox.exe -chrome "chrome://selenium-ide-testrunner/content/selenium/TestRunner.html..." . It's hard to resolve. In JRunner, we must choose a workaround substitution.
For solution, read topic: http://clearspace.openqa.org/message/51801#51801

Friday, November 7, 2008

Build a regression automation testing framework based on Selenium FIT mode

When company only has 100 regression test cases written by Selenese, QA steps to do regression tasks by Selenium FIT mode:
1) Organize test cases files with suites files on local driver or shared driver
2) Open Chrome TestRunner in Firefox
3) Import test suites address in file sytem, click run
4) Monitor and wait for run finished, manually collect run result and write a run report with generic result info.

Assume your company business's growth and you have 1000+ regression test cases.
How to execute these cases in a short time and generate report with detailed enough info automatically?
0) All QA upload and maintain test cases on a central portal.
1) Choose test cases you want to kick off regression from case repository
2) Specify necessary parameter for regression and kick off
3) A scalable machine matrix in backend begin to do automation run parallelly. There are also multiple instances running simuteniously on same machine. Each instance used Selenium FIT engine. The run snapshot/result/log are stored into filesytem/DB runtimely by above instances called Agent.
4) When all run finished, a report can be generated from file sytem/DB.

It's feasible to implement such a system with Selenium FIT mode.

Comparing to similar system based on S-RC+S-GRID:
1) No need proxy server, more lightweight framework. No need precompile like .java test case source.
2) Firefox Chrome TestRunner is more stable and faster than RC Runner. It can bypass many issues which RC can't resolve. Chrome XPCOM APIs is very powerful for develop Selenium new features.
3) User only need to know how to create a Selenese test case, no other skill requirement.

Thursday, November 6, 2008

FIT mode best choice: running Selenium with Firefox Chrome TestRunner

I don't think Selenium-RC is the best choice for QA who does feature testing & regression testing with blackbox style, esp. those who doesn't have programming background.

S-RC(JAVA) disadvantages for blackbox QA/regression testing:
1) programming skills trainning cost for QA
2) test code complexity for maintenance
3) bad HTTPS/SSL page support
4) popup/alerts make automation stuck, require an autoclick alerts mechanism
5) not stable and with weird issues caused by Proxy Server
6) not lightweight tools, need setup environment
7) still need do 2nd around development to integrate with regression distributed system(even if S-GRID).

FIT mode is familiared by QA. There has 3 ways:
1) deploy Selenium CORE/TEST on testing server
2) MS IEHTA with test case repository anywhere
3) Firefox Chrome by Selenium-IDE with test case repository anywhere

For 1), some company has restriction to deny to do deployment
For 2), IEHTA is unstable and has critial issues such as multiwindow popup,xpath slowness etc. It's also hard to provide a session/cache isolation solution for multiple instances running simultaniously on one machine. It's also hard to create a recorder for IE.

I think running Selenium with Firefox Chrome TestRunner is the best choice for FIT mode.
1) Selenium-IDE is a good tool with recorder and still can do huge improvements.
2) Stable and well support HTTPS. Well support multiwindow.
3) multiple selenium running simultaniously on same machine with session/cache isolation by Firefox profiles mechanism
4) set FF preferences to let Selenium not stuck(click out popup/alerts)
5) save run snapshot/results/log to local file system other than postUrl solution
6) No need any proxy server. No need any additional installation and configuration.
7) Opensource Firefox platform is developer friendly. Firefox Chrome's XPCOM APIs can support us to implement all kinds of selenium features.

However, the bottleneck for openqa's FIT mode(Esp. Selenium-IDE) not become enterprise usage:
1) Selenium-IDE doesn't save down detailed enough snapshot/results/log to local file system which is the significant requirement for enterprise tools. Many other significant requirements also haven't been implemented.
2) FIT mode doesn't provide neccessary development SDK. We can build our enterprise test case maintenance system with GUI/webflow, parallel execution system with distributed infrastructure, result reporting system with DB/file system. However, we need SDK APIs to integrate Selenium FIT engine into these systems.

Most of developers are contributing for S-RC product on community. I hope openqa can also push Selenium-IDE FIT product line for enterprise usage.

Monday, November 3, 2008

Selenium FIT mode vs. Driven mode

Selenium has two usage modes:
1)FIT mode: table style simple script which usually run on Selenium CORE/IDE in standalone IE/FF. We also call it as 'Selenese'. It's simple and easy to install/use for QA with no programming skills.
This is more for "black box" testing and is "asynchronous" in design.
You send the whole test script over to the browser in a "REST" fashion, it generally only has the same access to click and type and change things as a regular user would.

2)Driven mode: a language specific driver for Selenium. It used a proxy server to bypass Same Origin Policy for Selenium. Selenium RC is the product for this mode.
This enables "white box" testing and also "synchronous" in design.
With white box testing, you can send one command to the browser in an "RPC" fashion, get a result, then check the back-end database to confirm like Unit Test. You can benifit from programming lauguage like Java for Selenium.

Read Jason Huggins' topic: Choosing between "Driven Mode" and "FIT or Table style"

Saturday, November 1, 2008

Open Blogger space here for Selenium Test related topics

We have used Selenium as primary automation technology for our big website for years.
I open a Blogger space here to share my Selenium exploration and tips with my engineer friends.

I named here as 'Selenium Galaxy' and please bookmark its URL: http://sejq.blogspot.com/

I will move our tech docs here successionally.