jQuery jQuery.trim() Method

What You’ll Learn

The jQuery.trim() utility strips whitespace from the start and end of a string — spaces, tabs, newlines, and non-breaking spaces — while leaving internal spacing intact. This tutorial covers syntax, the official jQuery API example, form-input cleanup, comparisons with native String.prototype.trim(), and migration notes for jQuery 3.5+.

Introduction

User input rarely arrives perfectly formatted. Copy-pasted text, form fields, and API responses often include accidental spaces or line breaks at the edges. jQuery introduced jQuery.trim() (also written $.trim()) in version 1.0 as a reliable way to clean those strings before validation or display.

Today, every modern browser and Node.js supports native String.prototype.trim(), and jQuery has deprecated $.trim(). This page teaches how the utility works, why it mattered historically, and what to use when upgrading legacy code.

Understanding the jQuery.trim() Method

jQuery.trim(str) scans a string from both ends and removes whitespace characters — ordinary spaces, tabs (\t), carriage returns (\r), line feeds (\n), and non-breaking spaces — until it hits the first non-whitespace character. The original string is never modified; a cleaned copy is returned.

Whitespace that appears between words is preserved. That distinction matters when normalizing names, addresses, or any text where internal spacing carries meaning.

📝 Syntax

General form of jQuery.trim:

jQuery.trim( str )
// or
$.trim( str )

Parameters

• str — the string to trim. Pass a string value for predictable results, especially when migrating to native trim().

Return value

• A new string with leading and trailing whitespace removed.
• An empty string when the input contains only whitespace.

Official jQuery API example

$.trim(" hello, how are you? ");
// "hello, how are you?"

Examples Gallery

Each example uses $.trim(). Open DevTools or use the Try-it links. Example 1 matches the official jQuery API documentation.

var result = $.trim(" hello, how are you? ");

console.log(result);
// "hello, how are you?"

hello, how are you?

var raw = "   codetofun   ";
var username = $.trim(raw);

console.log("Length:", username.length); // 9
console.log("Valid:", username.length >= 3); // true

Length: 9
Valid: true

var text = "  hello   world  ";
var cleaned = $.trim(text);

console.log(JSON.stringify(cleaned));
// "hello   world"

"hello   world"

var pasted = "\n\t  Save draft  \r\n";
var cleaned = $.trim(pasted);

console.log(JSON.stringify(cleaned));
// "Save draft"

"Save draft"

function isBlank(value) {
  return $.trim(value) === "";
}

console.log(isBlank("   "));        // true
console.log(isBlank("  hi  "));     // false
console.log(isBlank("\n\t\r"));     // true

true
false
true

🚀 Common Use Cases

• Form validation — normalize text inputs before length, email, or pattern checks.
• Search boxes — ignore accidental leading/trailing spaces in queries.
• CSV / paste cleanup — strip newline padding from copied spreadsheet cells.
• String comparison — compare trimmed values so "admin" matches " admin ".
• Plugin defaults — sanitize option strings read from data-* attributes.
• Legacy IE support — historical reason jQuery shipped its own trim before ES5 was universal.

📝 Notes

• Available since jQuery 1.0; deprecated in jQuery 3.5; removed in jQuery 4.0.
• Prefer native String.prototype.trim() in new code and when upgrading.
• Unlike native trim(), always pass a string to avoid surprises with null, undefined, or numbers during migration.
• Does not collapse internal whitespace — only leading and trailing characters.
• For one-sided trimming, native trimStart() / trimEnd() (ES2019) are available.
• jQuery also used trim internally when reading certain attribute values in older versions.

💡 Best Practices