Addresscheck

Realtime email address validation using JavaScript.

Requirements

Mailocator snippet must be present

If you do not have installed Mailocator in your website, please read Mailocator installation notes at first.

Addresscheck must be switched on

Go to Mailocator app
Choose your campaign
Open Features & Settings in top menu
Select E-mail validation
Switch Addresscheck on and follow further instructions

Email validation

Realtime form validation process

Validation proces is based on simple JavaScript request and callback function.

When you want to check given emai address, simply call following Mailocator Action: mailocator.action.validate( email, callback )

- email is variable with email address

- callback is a callback function called by Mailocator when validation is done and receive only one argument - result object

The validation process can take from milliseconds to several seconds depending on mailserver response etc.

Result object description

Propery	Description
status	`1` email passed validation `0` email syntax error `-1` email not passed and is considered as invalid
email	validated email
suggestion	contain correct email address suggestion, if possible
time	unix timestamp of last check
mesg	text description of the process
detail	object with particular tests and its results like bounceRisk, mailserver check, ...

Example

Basic form with email input and onclick event

<h1>Email validation</h1>	    
<input type="text" name="email" value="" id="emladdr" size="50" />	    
<button onclick="validate()">Validate</button>
<div id="validation_result"></div>

Custom function

Validate email input by passing in Mailocator action.

function validate(){
    var email  = document.getElementById('emladdr').value;
    mailocator.action.validate( email, callback );      
}

Callback function

Evaluate validation result, display messages or continue processing data...

function callback( result ){
 
    // see result object
    console.log( result  );
     
    // status is a number
    var status = parseInt(result.status);
       
    // display validation result
    var message = document.getElementById('validation_result');
    			    
    // email seems to be invalid
    if( status<1 ){
		
       // email syntax error
       if( status===0 )
          message.innerHTML = 'Please correct your address';
		    
       // email syntax error
       if( status==-1 ){					    
          message.innerHTML = 'Please, check your address.';
          if( result.suggestion ){
               message.innerHTML += ' Did you mean ';
               message.innerHTML += result.suggestion + '?';
          } 
       }
    }
    else {					    
       // email is correct
       message.innerHTML = 'Email seems to be correct!';	    
       
       // continue processing...
    }			        
}

Email address validation