youtube-link-utils

Installation

npm install @genway-ai/youtube-link-utils

Usage

Node.js / ES Modules

import {
 isValidYouTubeUrl,
 extractYouTubeVideoId,
 convertYouTubeToEmbedUrl,
 getYouTubeVideoInfo,
} from '@genway-ai/youtube-link-utils';
// Basic validation
const url = 'https://www.youtube.com/watch?v=dQw4w9WgXcQ';
console.log(isValidYouTubeUrl(url)); // true
// Extract video ID
const videoId = extractYouTubeVideoId(url);
console.log(videoId); // 'dQw4w9WgXcQ'
// Convert to embed URL
const embedUrl = convertYouTubeToEmbedUrl(url);
console.log(embedUrl); // 'https://www.youtube.com/embed/dQw4w9WgXcQ?autoplay=1...'
// Fetch video information (requires axios)
const videoInfo = await getYouTubeVideoInfo(url);
console.log(videoInfo?.title); // Video title

CommonJS

const {
 isValidYouTubeUrl,
 extractYouTubeVideoId,
} = require('@genway-ai/youtube-link-utils');
const isValid = isValidYouTubeUrl('https://youtu.be/dQw4w9WgXcQ');
console.log(isValid); // true

Browser (CDN)

<script src="https://unpkg.com/@genway-ai/youtube-link-utils/dist/index.browser.js"></script>
<script>
 const { isValidYouTubeUrl, extractYouTubeVideoId } = YouTubeLinkUtils;
 const isValid = isValidYouTubeUrl(
 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
 );
 console.log(isValid); // true
</script>

API Reference

isValidYouTubeUrl(url: string): boolean

extractYouTubeVideoId(url: string): string | null

convertYouTubeToEmbedUrl(url: string): string | null

getYouTubeVideoInfo(url: string): Promise<VideoInfo | null>

validateYouTubeUrlComprehensive(url: string, checkExists?: boolean): Promise<YouTubeValidationResult>

React Hook

useYouTubeValidationLoading()

// Import the hook directly from the react subpath
import { useYouTubeValidationLoading } from '@genway-ai/youtube-link-utils/react';
function VideoForm() {
 const { isValidating, validateWithLoading, clearValidation } =
 useYouTubeValidationLoading();
 const [url, setUrl] = useState('');
 const [isValid, setIsValid] = useState(null);
 const handleValidate = async () => {
 const result = await validateWithLoading(url);
 setIsValid(result);
 };
 const handleClear = () => {
 clearValidation();
 setUrl('');
 setIsValid(null);
 };
 return (
 <div>
 <input
 value={url}
 onChange={e => setUrl(e.target.value)}
 placeholder="Enter YouTube URL"
 disabled={isValidating}
 />
 <button onClick={handleValidate} disabled={isValidating}>
 {isValidating ? 'Validating...' : 'Validate'}
 </button>
 <button onClick={handleClear}>Clear</button>
 {isValid !== null && (
 <p>{isValid ? 'Valid YouTube URL!' : 'Invalid YouTube URL'}</p>
 )}
 </div>
 );
}

Peer Dependencies

npm install axios

npm install react

Supported URL Formats

TypeScript

import type { YouTubeValidationResult } from '@genway-ai/youtube-link-utils';