在日常开发中，JavaScript 顶层 await 使用场景 is being used more and more frequently. This article systematically explains its usage, principles, and optimization strategies.

Quick Start

Here is a complete example:

'use client'
import { useChat } from 'ai/react'

export function AIChat() {
  const { messages, input, handleInputChange, handleSubmit, isLoading } = useChat({
    api: '/api/chat'
  })
  return (
    <div className="chat-container">
      {messages.map(m => (
        <div key={m.id} className={`message ${m.role}`}>
          <p>{m.content}</p>
        </div>
      ))}
      <form onSubmit={handleSubmit}>
        <input value={input} onChange={handleInputChange} />
        <button type="submit" disabled={isLoading}>发送</button>
      </form>
    </div>
  )
}

Pay attention to boundary condition handling, which is critical in production.

Internal Principles

The key lies in understanding the core logic:

import { openai } from '@ai-sdk/openai'
import { streamText } from 'ai'

export async function POST(req) {
  const { messages } = await req.json()
  const result = await streamText({
    model: openai('gpt-4o'),
    messages,
    system: '你是一个专业的前端开发助手。',
    maxTokens: 2000
  })
  return result.toDataStreamResponse()
}

Performance optimization should be tailored to specific scenarios; not all cases require over-optimization.

Business Practice

We can improve it in the following ways:

'use client'
import { useChat } from 'ai/react'

export function AIChat() {
  const { messages, input, handleInputChange, handleSubmit, isLoading } = useChat({
    api: '/api/chat'
  })
  return (
    <div className="chat-container">
      {messages.map(m => (
        <div key={m.id} className={`message ${m.role}`}>
          <p>{m.content}</p>
        </div>
      ))}
      <form onSubmit={handleSubmit}>
        <input value={input} onChange={handleInputChange} />
        <button type="submit" disabled={isLoading}>发送</button>
      </form>
    </div>
  )
}

This approach has been running stably in production for over six months and has been practically validated.

Performance Comparison

Let's start with the basic implementation:

import { openai } from '@ai-sdk/openai'
import { streamText } from 'ai'

export async function POST(req) {
  const { messages } = await req.json()
  const result = await streamText({
    model: openai('gpt-4o'),
    messages,
    system: '你是一个专业的前端开发助手。',
    maxTokens: 2000
  })
  return result.toDataStreamResponse()
}

This code demonstrates the basic usage. In real projects, you also need to consider error handling and edge cases.

Troubleshooting

Building on this foundation, we can further optimize:

'use client'
import { useChat } from 'ai/react'

export function AIChat() {
  const { messages, input, handleInputChange, handleSubmit, isLoading } = useChat({
    api: '/api/chat'
  })
  return (
    <div className="chat-container">
      {messages.map(m => (
        <div key={m.id} className={`message ${m.role}`}>
          <p>{m.content}</p>
        </div>
      ))}
      <form onSubmit={handleSubmit}>
        <input value={input} onChange={handleInputChange} />
        <button type="submit" disabled={isLoading}>发送</button>
      </form>
    </div>
  )
}

This pattern is very practical in large projects and can significantly reduce maintenance costs.

Summary

• Understanding underlying principles is more important than memorizing APIs
• Always verify compatibility before using in production
• In team collaboration, conventions and documentation are more important than the technology itself