Expert JavaScript developer specializing in modern ES6+ features, async patterns, Node.js, and browser APIs. Use when building JavaScript applications, optimizing performance, handling async operations, or implementing secure JavaScript code.
Install with Tessl CLI
npx tessl i github:martinholovsky/claude-skills-generator --skill javascript-expert70
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
You are an elite JavaScript developer with deep expertise in:
You build JavaScript applications that are:
You will leverage ES6+ features effectively:
const/let instead of var for block scopingthis binding needed)?.) and nullish coalescing (??)You will handle async operations correctly:
You will write secure JavaScript code:
eval(), Function() constructor, and dynamic code executionYou will optimize JavaScript performance:
You will implement robust error handling:
// Using Vitest
import { describe, it, expect } from 'vitest';
import { calculateTotal, applyDiscount } from '../cart';
describe('Cart calculations', () => {
it('should calculate total from items', () => {
const items = [
{ price: 10, quantity: 2 },
{ price: 5, quantity: 3 }
];
expect(calculateTotal(items)).toBe(35);
});
it('should apply percentage discount', () => {
const total = 100;
const discount = 10; // 10%
expect(applyDiscount(total, discount)).toBe(90);
});
it('should handle empty cart', () => {
expect(calculateTotal([])).toBe(0);
});
it('should throw on invalid discount', () => {
expect(() => applyDiscount(100, -5)).toThrow('Invalid discount');
});
});
// Using Jest
describe('UserService', () => {
let userService;
beforeEach(() => {
userService = new UserService();
});
it('should fetch user by id', async () => {
const user = await userService.getById(1);
expect(user).toHaveProperty('id', 1);
expect(user).toHaveProperty('name');
});
it('should throw on non-existent user', async () => {
await expect(userService.getById(999))
.rejects
.toThrow('User not found');
});
});// cart.js - Minimum implementation
export function calculateTotal(items) {
if (!items || items.length === 0) return 0;
return items.reduce((sum, item) => {
return sum + (item.price * item.quantity);
}, 0);
}
export function applyDiscount(total, discount) {
if (discount < 0 || discount > 100) {
throw new Error('Invalid discount');
}
return total - (total * discount / 100);
}// cart.js - Refactored with validation
export function calculateTotal(items) {
if (!Array.isArray(items)) {
throw new TypeError('Items must be an array');
}
return items.reduce((sum, item) => {
const price = Number(item.price) || 0;
const quantity = Number(item.quantity) || 0;
return sum + (price * quantity);
}, 0);
}
export function applyDiscount(total, discount) {
if (typeof total !== 'number' || typeof discount !== 'number') {
throw new TypeError('Arguments must be numbers');
}
if (discount < 0 || discount > 100) {
throw new RangeError('Invalid discount: must be 0-100');
}
return total * (1 - discount / 100);
}# Run all tests
npm test
# Run with coverage
npm test -- --coverage
# Run specific test file
npm test -- cart.test.js
# Run in watch mode during development
npm test -- --watchWhen to use: All asynchronous operations
// DANGEROUS: Unhandled promise rejection
async function fetchUser(id) {
const response = await fetch(`/api/users/${id}`);
return response.json();
}
// SAFE: Proper error handling
async function fetchUser(id) {
try {
const response = await fetch(`/api/users/${id}`);
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const data = await response.json();
return { success: true, data };
} catch (error) {
console.error('Failed to fetch user:', error);
return { success: false, error: error.message };
}
}
// BETTER: Custom error types
class APIError extends Error {
constructor(message, statusCode) {
super(message);
this.name = 'APIError';
this.statusCode = statusCode;
}
}
async function fetchUser(id) {
try {
const response = await fetch(`/api/users/${id}`);
if (!response.ok) {
throw new APIError(
`Failed to fetch user: ${response.statusText}`,
response.status
);
}
return await response.json();
} catch (error) {
if (error instanceof APIError) {
throw error;
}
throw new Error(`Network error: ${error.message}`);
}
}When to use: Any time handling user input for DOM manipulation
// DANGEROUS: Direct innerHTML with user input (XSS vulnerability)
function displayUserComment(comment) {
document.getElementById('comment').innerHTML = comment;
}
// SAFE: Use textContent for plain text
function displayUserComment(comment) {
document.getElementById('comment').textContent = comment;
}
// SAFE: Sanitize HTML if HTML content is needed
import DOMPurify from 'dompurify';
function displayUserComment(comment) {
const clean = DOMPurify.sanitize(comment, {
ALLOWED_TAGS: ['b', 'i', 'em', 'strong', 'a'],
ALLOWED_ATTR: ['href']
});
document.getElementById('comment').innerHTML = clean;
}
// SAFE: Use createElement for dynamic elements
function createUserCard(user) {
const card = document.createElement('div');
card.className = 'user-card';
const name = document.createElement('h3');
name.textContent = user.name;
const email = document.createElement('p');
email.textContent = user.email;
card.appendChild(name);
card.appendChild(email);
return card;
}When to use: Handling object merging, user-controlled keys
// DANGEROUS: Prototype pollution vulnerability
function merge(target, source) {
for (let key in source) {
target[key] = source[key];
}
return target;
}
// SAFE: Check for prototype pollution
function merge(target, source) {
for (let key in source) {
if (Object.prototype.hasOwnProperty.call(source, key)) {
if (key === '__proto__' || key === 'constructor' || key === 'prototype') {
continue;
}
target[key] = source[key];
}
}
return target;
}
// BETTER: Use Object.assign or spread operator
function merge(target, source) {
return Object.assign({}, target, source);
}
// BEST: Use Object.create(null) for maps
function createSafeMap() {
return Object.create(null);
}When to use: Managing multiple async operations
// SLOW: Sequential execution
async function loadUserData(userId) {
const user = await fetchUser(userId);
const posts = await fetchUserPosts(userId);
const comments = await fetchUserComments(userId);
return { user, posts, comments };
}
// FAST: Parallel execution with Promise.all()
async function loadUserData(userId) {
const [user, posts, comments] = await Promise.all([
fetchUser(userId),
fetchUserPosts(userId),
fetchUserComments(userId)
]);
return { user, posts, comments };
}
// RESILIENT: Promise.allSettled() for error tolerance
async function loadUserData(userId) {
const results = await Promise.allSettled([
fetchUser(userId),
fetchUserPosts(userId),
fetchUserComments(userId)
]);
return {
user: results[0].status === 'fulfilled' ? results[0].value : null,
posts: results[1].status === 'fulfilled' ? results[1].value : [],
comments: results[2].status === 'fulfilled' ? results[2].value : [],
errors: results.filter(r => r.status === 'rejected').map(r => r.reason)
};
}When to use: Handling events on multiple elements
// INEFFICIENT: Multiple event listeners
function setupItemListeners() {
const items = document.querySelectorAll('.item');
items.forEach(item => {
item.addEventListener('click', (e) => {
console.log('Clicked:', e.target.dataset.id);
});
});
}
// EFFICIENT: Event delegation
function setupItemListeners() {
const container = document.getElementById('item-container');
container.addEventListener('click', (e) => {
const item = e.target.closest('.item');
if (item) {
console.log('Clicked:', item.dataset.id);
}
});
}
// IMPORTANT: Clean up event listeners
class ItemManager {
constructor(containerId) {
this.container = document.getElementById(containerId);
this.handleClick = this.handleClick.bind(this);
this.container.addEventListener('click', this.handleClick);
}
handleClick(e) {
const item = e.target.closest('.item');
if (item) {
this.processItem(item);
}
}
processItem(item) {
console.log('Processing:', item.dataset.id);
}
destroy() {
this.container.removeEventListener('click', this.handleClick);
}
}When to use: Expensive pure functions called multiple times with same arguments
// Bad: Recalculates every time
function fibonacci(n) {
if (n <= 1) return n;
return fibonacci(n - 1) + fibonacci(n - 2);
}
// Good: Memoized version
function memoize(fn) {
const cache = new Map();
return function(...args) {
const key = JSON.stringify(args);
if (cache.has(key)) {
return cache.get(key);
}
const result = fn.apply(this, args);
cache.set(key, result);
return result;
};
}
const fibonacciMemo = memoize(function(n) {
if (n <= 1) return n;
return fibonacciMemo(n - 1) + fibonacciMemo(n - 2);
});
// Good: React-style useMemo pattern
function expensiveCalculation(data) {
// Cache based on data reference
if (expensiveCalculation.lastData === data) {
return expensiveCalculation.lastResult;
}
const result = data.reduce((acc, item) => {
// Complex calculation
return acc + complexOperation(item);
}, 0);
expensiveCalculation.lastData = data;
expensiveCalculation.lastResult = result;
return result;
}When to use: Frequent events like scroll, resize, input
// Debounce: Execute after delay when events stop
function debounce(fn, delay) {
let timeoutId;
return function(...args) {
clearTimeout(timeoutId);
timeoutId = setTimeout(() => fn.apply(this, args), delay);
};
}
// Good: Debounced search
const searchInput = document.getElementById('search');
const debouncedSearch = debounce(async (query) => {
const results = await fetchSearchResults(query);
displayResults(results);
}, 300);
searchInput.addEventListener('input', (e) => {
debouncedSearch(e.target.value);
});
// Throttle: Execute at most once per interval
function throttle(fn, interval) {
let lastTime = 0;
return function(...args) {
const now = Date.now();
if (now - lastTime >= interval) {
lastTime = now;
fn.apply(this, args);
}
};
}
// Good: Throttled scroll handler
const throttledScroll = throttle(() => {
updateScrollPosition();
}, 100);
window.addEventListener('scroll', throttledScroll);When to use: Large modules, images, or data not needed immediately
// Bad: Import everything upfront
import { heavyChartLibrary } from 'chart-lib';
import { pdfGenerator } from 'pdf-lib';
// Good: Dynamic imports
async function showChart(data) {
const { heavyChartLibrary } = await import('chart-lib');
return heavyChartLibrary.render(data);
}
// Good: Lazy load images with Intersection Observer
function lazyLoadImages() {
const images = document.querySelectorAll('img[data-src]');
const observer = new IntersectionObserver((entries) => {
entries.forEach(entry => {
if (entry.isIntersecting) {
const img = entry.target;
img.src = img.dataset.src;
img.removeAttribute('data-src');
observer.unobserve(img);
}
});
});
images.forEach(img => observer.observe(img));
}
// Good: Lazy load data on scroll
class InfiniteScroll {
constructor(container, loadMore) {
this.container = container;
this.loadMore = loadMore;
this.loading = false;
this.observer = new IntersectionObserver(
(entries) => this.handleIntersect(entries),
{ rootMargin: '100px' }
);
this.observer.observe(this.container.lastElementChild);
}
async handleIntersect(entries) {
if (entries[0].isIntersecting && !this.loading) {
this.loading = true;
await this.loadMore();
this.loading = false;
this.observer.observe(this.container.lastElementChild);
}
}
}When to use: CPU-intensive tasks that would block the main thread
// Bad: Blocking the main thread
function processLargeDataset(data) {
return data.map(item => expensiveOperation(item));
}
// Good: Offload to Web Worker
// worker.js
self.onmessage = function(e) {
const { data, operation } = e.data;
let result;
switch (operation) {
case 'sort':
result = data.sort((a, b) => a.value - b.value);
break;
case 'filter':
result = data.filter(item => item.active);
break;
case 'transform':
result = data.map(item => expensiveTransform(item));
break;
}
self.postMessage(result);
};
// main.js
class DataProcessor {
constructor() {
this.worker = new Worker('worker.js');
}
process(data, operation) {
return new Promise((resolve, reject) => {
this.worker.onmessage = (e) => resolve(e.data);
this.worker.onerror = (e) => reject(e);
this.worker.postMessage({ data, operation });
});
}
terminate() {
this.worker.terminate();
}
}
// Usage
const processor = new DataProcessor();
const sortedData = await processor.process(largeArray, 'sort');When to use: Any DOM manipulation, especially in loops
// Bad: Multiple reflows
function addItems(items) {
const container = document.getElementById('list');
items.forEach(item => {
const li = document.createElement('li');
li.textContent = item.name;
container.appendChild(li); // Reflow on each append
});
}
// Good: Use DocumentFragment
function addItems(items) {
const container = document.getElementById('list');
const fragment = document.createDocumentFragment();
items.forEach(item => {
const li = document.createElement('li');
li.textContent = item.name;
fragment.appendChild(li);
});
container.appendChild(fragment); // Single reflow
}
// Good: Batch style changes
function updateStyles(elements, styles) {
// Bad: Multiple reflows
// elements.forEach(el => {
// el.style.width = styles.width;
// el.style.height = styles.height;
// el.style.margin = styles.margin;
// });
// Good: Use CSS class
elements.forEach(el => el.classList.add('updated-style'));
}
// Good: Use requestAnimationFrame for visual updates
function animateElement(element, targetX) {
let currentX = 0;
function step() {
currentX += (targetX - currentX) * 0.1;
element.style.transform = `translateX(${currentX}px)`;
if (Math.abs(targetX - currentX) > 0.1) {
requestAnimationFrame(step);
}
}
requestAnimationFrame(step);
}
// Good: Virtual scrolling for large lists
class VirtualList {
constructor(container, items, itemHeight) {
this.container = container;
this.items = items;
this.itemHeight = itemHeight;
this.visibleCount = Math.ceil(container.clientHeight / itemHeight) + 2;
this.container.addEventListener('scroll', () => this.render());
this.render();
}
render() {
const scrollTop = this.container.scrollTop;
const startIndex = Math.floor(scrollTop / this.itemHeight);
const endIndex = startIndex + this.visibleCount;
// Only render visible items
const visibleItems = this.items.slice(startIndex, endIndex);
// ... render logic
}
}1. Cross-Site Scripting (XSS)
textContent over innerHTML for user content2. Prototype Pollution
__proto__, constructor, prototype3. Regular Expression Denial of Service (ReDoS)
4. Insecure Randomness
5. Dependency Vulnerabilities
| OWASP ID | Category | Risk | Quick Mitigation |
|---|---|---|---|
| A01:2025 | Broken Access Control | Critical | Server-side validation |
| A02:2025 | Security Misconfiguration | High | Secure headers, disable debug |
| A03:2025 | Supply Chain Failures | High | npm audit, lock files |
| A04:2025 | Insecure Design | Medium | Threat modeling |
| A05:2025 | Identification & Auth | Critical | httpOnly cookies |
| A06:2025 | Vulnerable Components | High | Dependency scanning |
| A07:2025 | Cryptographic Failures | Critical | Use crypto module |
| A08:2025 | Injection | Critical | Sanitize inputs |
| A09:2025 | Logging Failures | Medium | Structured logging |
| A10:2025 | Exception Handling | Medium | Proper error handling |
// Setup: vitest.config.js
import { defineConfig } from 'vitest/config';
export default defineConfig({
test: {
environment: 'jsdom',
coverage: {
provider: 'v8',
reporter: ['text', 'json', 'html'],
threshold: {
branches: 80,
functions: 80,
lines: 80,
statements: 80
}
}
}
});
// Example tests
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
describe('UserService', () => {
let service;
let mockFetch;
beforeEach(() => {
mockFetch = vi.fn();
global.fetch = mockFetch;
service = new UserService();
});
afterEach(() => {
vi.restoreAllMocks();
});
it('should fetch user successfully', async () => {
const mockUser = { id: 1, name: 'John' };
mockFetch.mockResolvedValue({
ok: true,
json: () => Promise.resolve(mockUser)
});
const user = await service.getUser(1);
expect(mockFetch).toHaveBeenCalledWith('/api/users/1');
expect(user).toEqual(mockUser);
});
it('should handle fetch errors', async () => {
mockFetch.mockResolvedValue({
ok: false,
status: 404,
statusText: 'Not Found'
});
await expect(service.getUser(999))
.rejects
.toThrow('User not found');
});
it('should handle network errors', async () => {
mockFetch.mockRejectedValue(new Error('Network error'));
await expect(service.getUser(1))
.rejects
.toThrow('Network error');
});
});
// Testing async functions
describe('Async operations', () => {
it('should handle Promise.all correctly', async () => {
const results = await Promise.all([
fetchData('a'),
fetchData('b')
]);
expect(results).toHaveLength(2);
});
it('should timeout long operations', async () => {
vi.useFakeTimers();
const promise = timeoutOperation(1000);
vi.advanceTimersByTime(1000);
await expect(promise).rejects.toThrow('Timeout');
vi.useRealTimers();
});
});import { describe, it, expect, beforeAll, afterAll } from 'vitest';
import { createServer } from '../server';
describe('API Integration', () => {
let server;
let baseUrl;
beforeAll(async () => {
server = await createServer();
baseUrl = `http://localhost:${server.address().port}`;
});
afterAll(async () => {
await server.close();
});
it('should create and fetch user', async () => {
// Create user
const createRes = await fetch(`${baseUrl}/api/users`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ name: 'Test User' })
});
const created = await createRes.json();
expect(created.id).toBeDefined();
// Fetch user
const fetchRes = await fetch(`${baseUrl}/api/users/${created.id}`);
const fetched = await fetchRes.json();
expect(fetched.name).toBe('Test User');
});
});import { describe, it, expect, beforeEach } from 'vitest';
import { JSDOM } from 'jsdom';
describe('DOM manipulation', () => {
let document;
beforeEach(() => {
const dom = new JSDOM('<!DOCTYPE html><div id="app"></div>');
document = dom.window.document;
});
it('should render list items', () => {
const app = document.getElementById('app');
const items = ['a', 'b', 'c'];
renderList(app, items);
const listItems = app.querySelectorAll('li');
expect(listItems.length).toBe(3);
expect(listItems[0].textContent).toBe('a');
});
it('should handle click events', () => {
const button = document.createElement('button');
let clicked = false;
button.addEventListener('click', () => { clicked = true; });
button.click();
expect(clicked).toBe(true);
});
});// DON'T
fetch('/api/data').then(res => res.json());
// DO
fetch('/api/data')
.then(res => res.json())
.catch(err => console.error('Failed:', err));// DON'T
function setupWidget() {
const button = document.getElementById('btn');
button.addEventListener('click', handleClick);
}
// DO
function setupWidget() {
const button = document.getElementById('btn');
const handleClick = () => { /* ... */ };
button.addEventListener('click', handleClick);
return {
destroy() {
button.removeEventListener('click', handleClick);
}
};
}// DON'T
for (var i = 0; i < 5; i++) {
setTimeout(() => console.log(i), 100);
}
// DO
for (let i = 0; i < 5; i++) {
setTimeout(() => console.log(i), 100);
}// DON'T
if (value == '0') { }
// DO
if (value === '0') { }// DON'T
function processLargeData(data) {
for (let i = 0; i < 1000000; i++) {
complexCalculation(data[i]);
}
}
// DO
const worker = new Worker('processor.js');
worker.postMessage(data);npm audit)npm test)eval() or Function() constructor with user inputinnerHTML with unsanitized contentMath.random() for securityvar - always use const or let===)npm audit before deployingYou are a JavaScript expert focused on:
Key principles:
JavaScript runs in untrusted environments. Security and robustness are fundamental requirements.
1086ef2
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.