ColdFusion User Defined Function: URLExists()

A ColdFusion user asked me for a way to programmatically determine if a URL exists, so I threw together this UDF. It uses to attempt to retrieve a specified URL (not resolving any internal URLs, and not throwing an error upon failure). If an HTTP status code 404 is returned then the UDF returns false, otherwise it returns true. The code is not just checking for status code 200 (or 2xx, for that matter), and this means that codes like 401 (unauthorized) and 403 (forbidden) will return true (these status codes do not necessarily mean that the URL does not exist).

Updated as per Steve’s sugestion and Gus’ important feedback.

9 responses to “ColdFusion User Defined Function: URLExists()”

  1. Raymond Camden Avatar
    Raymond Camden

    May I "steal" this for cflib?

  2. Steven Erat Avatar
    Steven Erat

    You might want to use CFHTTP method="head" instead of the default method="get". Its faster because it only retrieves the headers not the full page content, although it does depend on the the webserver being configured to accept the head method.

  3. Gus Avatar

    This function is not quite correct. You need to first check that status code is actually returned. If you run your code against a domain that doesn’t resolve, you won’t get a status code to check and will throw an error. Try it with
    The corrected code should be:
    <!— Does a URL exist? Checks for 404 status code. —>
    <cffunction name="URLExists" output="no" returntype="boolean">
    <!— Accepts a URL —>
    <cfargument name="u" type="string" required="yes">
    <!— Initialize result —>
    <cfset var result=true>
    <!— Attempt to retrieve the URL —>
    <cfhttp url="#ARGUMENTS.u#" resolveurl="no" throwonerror="no" />
    <!— Check That a Status Code is Returned —>
    <cfif isDefined(‘cfhttp.responseheader.status_code’)>
    <cfif cfhttp.responseheader.status_code EQ "404">
    <!— If 404, return FALSE —>
    <cfset result=false>
    <!— No Status Code Returned —>
    <cfset result=false>
    <cfreturn result>

  4. Ben Forta Avatar
    Ben Forta

    Steve, Gus, good points, updated.
    Ray, sure, go for it.

  5. Raymond Camden Avatar
    Raymond Camden


  6. Ray Horn Avatar
    Ray Horn

    May I borrow this code for a short time for use in Geonosis(tm) ? I promise to return it just as soon as it’s been enhanced, optimized or otherwise improved. Thx.

  7. Noah Roberts Avatar
    Noah Roberts

    I realize this post is a few years old, but I still found it and tried to use it. I wanted to make note of a couple of issues I found for future users.
    I think the ‘NOT IsDefined("cfhttp.responseheader.statuscode") ‘ should be in parenthesis. Maybe I am just a paranoid programmer (I haven’t actually tested it), but I think that having the ‘NOT’ at the beginning of the statement without putting it into parenthesis would make the not work against the whole statement. For instance the status_code actually returns 404, the ‘NOT’ would make the whole statement false and the url would be deemed valid, even though it is not.
    …We’ll see if this makes it past the spam filter… Hopefully my second half will as well…

  8. Noah Roberts Avatar
    Noah Roberts

    …Second half…
    I ran into another issue on my server. Its DNS provider still sends 200 status code if the URL does not exist. Maybe it is a bug in their code, but I added a check for it. Other DNS providers may have similar issues, so check for a known bad URL first and adapt as necessary. I checked cfhttp.responseheader.server for a "OpenDNS Guide".

  9. Noah Roberts Avatar
    Noah Roberts

    For some reason my comment is not showing up, but the second issue was with OpenDNS not returning 404.
    <cfif (NOT IsDefined("cfhttp.responseheader.status_code")) OR cfhttp.responseheader.status_code EQ "404" OR (IsDefined("cfhttp.responseheader.server") AND cfhttp.responseheader.server EQ "OpenDNS Guide")>

Leave a Reply